Skip to main content

kobana dashboards settings

Get organization settings

Commands of kobana dashboards settings. Every global option (Global options) applies here.

CommandHTTPDescription
settingsGET /v1/settingsGet organization settings
settings updatePUT /v1/settingsUpdate organization settings

settings​

Get organization settings

kobana dashboards settings [OPTIONS] [COMMAND]

GET /v1/settings

Name, support e-mail, timezone and the records options of the organization. Organization-level.

Headers

NameTypeRequiredDescription
X-Workspace-IdstringnoWorkspace the call acts on: the id or the public_id shown under Workspaces on the dashboard. Inside the token's organization, data lives in workspaces. It may be omitted while the organization has a single workspace; with two or more, leaving it out returns 400 workspace_required. A workspace outside the organization returns 403 unknown_workspace. With a person token, only the workspaces that person has access to are reachable (organization owners reach all of them); any other returns 403 workspace_access_denied.

Responses

HTTPDescription
200The settings.
404Resource not found in the current organization.

settings update​

Update organization settings

kobana dashboards settings update [OPTIONS]

PUT /v1/settings

Partially changes the settings: send only what changes. Unknown fields are refused (400).

Headers

NameTypeRequiredDescription
X-Workspace-IdstringnoWorkspace the call acts on: the id or the public_id shown under Workspaces on the dashboard. Inside the token's organization, data lives in workspaces. It may be omitted while the organization has a single workspace; with two or more, leaving it out returns 400 workspace_required. A workspace outside the organization returns 403 unknown_workspace. With a person token, only the workspaces that person has access to are reachable (organization owners reach all of them); any other returns 403 workspace_access_denied.

Request body

NameTypeRequiredDescription
namestringno
support_emailstring (email)no
timezonestringnoIANA timezone, e.g. America/Sao_Paulo.
crm_uppercase_namesbooleannoSave names in UPPERCASE.
crm_allow_edit_public_idbooleanno
crm_allow_edit_documentbooleanno
crm_allow_create_customersbooleanno
crm_allow_create_portal_usersbooleannoAllow creating portal users from the dashboard and by import.
crm_allow_edit_portal_user_emailbooleanno

More fields and nested objects: kobana schema dashboards.settings.update.

Responses

HTTPDescription
200The settings.
400Request body failed validation.
404Resource not found in the current organization.