Skip to main content

kobana dunning notification-preferences

Commands of kobana dunning notification-preferences. Every global option (Global options) applies here.

CommandHTTPDescription
notification-preferences listGET /v1/notification-preferencesGet notification preferences
notification-preferences updatePUT /v1/notification-preferencesUpdate notification preferences

notification-preferences list​

Get notification preferences

kobana dunning notification-preferences list [OPTIONS]

GET /v1/notification-preferences

Returns the effective gate per message type — types without a saved record appear with all channels enabled.

Headers

NameTypeRequiredDescription
X-Workspace-IdstringnoWorkspace the call acts on (id or public_id, listed by GET /v1/workspaces). Optional while the organization has a single workspace; with two or more, omitting it is 400 WORKSPACE_REQUIRED. A workspace of another organization is 403 UNKNOWN_WORKSPACE.

Responses

HTTPDescription
200Effective preferences per type.
404Resource not found or outside your organization.
413Request body larger than 2 MB.

notification-preferences update​

Update notification preferences

kobana dunning notification-preferences update [OPTIONS]

PUT /v1/notification-preferences

Upserts the submitted preferences (partial: only the included types are changed).

Headers

NameTypeRequiredDescription
X-Workspace-IdstringnoWorkspace the call acts on (id or public_id, listed by GET /v1/workspaces). Optional while the organization has a single workspace; with two or more, omitting it is 400 WORKSPACE_REQUIRED. A workspace of another organization is 403 UNKNOWN_WORKSPACE.

Request body

NameTypeRequiredDescription
preferencesarray<object>yes

More fields and nested objects: kobana schema dunning.notification-preferences.update.

Responses

HTTPDescription
200Preferences saved.
400Invalid request (validation error).
404Resource not found or outside your organization.
413Request body larger than 2 MB.