Skip to main content

Organization

Organization endpoints control settings, branding, tags, and feedback form customization shared across all users in the organization.

Most write endpoints require admin or owner role.

Get settings​

GET /api/settings

Returns the full organization settings object.

Update settings​

PUT /api/settings

Accepts a partial settings object. Requires admin role.

Reset settings​

POST /api/settings/reset

Resets all organization settings to their defaults. Requires admin role.

Tags​

Get organization tags​

GET /api/organization/general-tags

Update organization tags​

PUT /api/organization/general-tags
{ "tags": ["positive", "constructive", "urgent"] }

Update event-specific tags​

PUT /api/organization/tags

Feedback form customization​

Controls the appearance and copy of the public feedback submission form.

Get customization​

GET /api/organization/feedback-customization

Update customization​

PUT /api/organization/feedback-customization
{
  "headerText": "Share your thoughts",
  "placeholderText": "Your feedback is anonymous...",
  "submitButtonText": "Submit",
  "primaryColor": "#1849aa"
}

Chart settings​

Controls the default chart types and wordcloud behaviour in the Insights view.

Get chart settings​

GET /api/organization/chart-settings

Update chart settings​

PUT /api/organization/chart-settings
POST /api/organization/upload-logo
Content-Type: multipart/form-data

Uploads the organization logo shown on the public feedback form and room pages. Maximum 5 MB.

Subdomain lookup (public)​

GET /api/organization/subdomain/:subdomain

Returns basic organization info for a given subdomain. No auth required. Used during login to identify the correct organization.

Onboarding​

POST /api/settings/complete-onboarding

Marks the organization's onboarding flow as complete. Requires owner role.

Serious concern testing​

POST /api/settings/test-serious-concern
{ "text": "Sample feedback text to test against detection criteria" }

Runs the serious concern detection model against a sample string. Useful for tuning detection criteria without submitting real feedback. Requires admin role.

Request plan upgrade​

POST /api/organization/request-upgrade

Sends a plan upgrade request to the organization owner. Used when a non-owner hits a plan limit (e.g. seat cap).