Skip to main content

Portal settings

The settings of the workspace's portal: name, colors, sign-in, SSO, notifications and security headers. domain update sets the portal's address on the platform (and domain check-slug list says whether it is free), logo create / logo delete change the logo and favicon, and sender-identity create verifies the e-mail sender in AWS SES.

CommandHTTPDescription
portal-settings listGET /v1/portal_settingsGet portal settings
portal-settings updatePATCH /v1/portal_settingsUpdate portal settings
portal-settings domain updatePATCH /v1/portal_settings/domainSet portal address
portal-settings domain check-slug listGET /v1/portal_settings/domain/check_slugCheck address availability
portal-settings logo createPOST /v1/portal_settings/logoUpload portal image
portal-settings logo deleteDELETE /v1/portal_settings/logoDelete portal image
portal-settings sender-identity createPOST /v1/portal_settings/sender_identityVerify notification sender

Examples​

--params carries query, path and header parameters (id, page, filters, X-Workspace-Id); --json carries the request body; --fields limits which fields come back — worth using on every list/get to save context. See Global flags for the full reference.

# Get portal settings
kobana dashboards portal-settings list \
--fields "company_name,title,portal_slug,portal_domain"

# Update portal settings
kobana dashboards portal-settings update \
--json '{"company_name": "Aurora", "title": "Portal do cliente"}'

# Check address availability
kobana dashboards portal-settings domain check-slug list \
--params '{"slug": "aurora", "domain": "DOMINIO"}'

# Set portal address
kobana dashboards portal-settings domain update \
--json '{"slug": "aurora", "domain": "DOMINIO"}'

Next steps​