HUhumansignal
Organizations

Get organization settings

Changed on

Retrieve the settings for a specific organization by ID.

get/api/organizations/{id}

Request

  • Base URL
    http://localhost:8000
  • URL
    http://localhost:8000/api/organizations/{id}
  • Auth
    API key in header Authorization

Path parameters

idinteger required

Response

allow_unsafe_instruction_tagsboolean required
created_atstring date-time required
custom_interfaces_enabledboolean nullable

Enable custom interfaces for this organization. When disabled, projects with use_custom_interface=True will not render custom interfaces anywhere in the product (label stream, embed, data manager, interfaces dashboard).

custom_scripts_enabledboolean required
default_role'OW' | 'AD' | 'MA' | 'RE' | 'AN' | 'DI' | 'NO' | 'VO'
  • OW - Owner
  • AD - Administrator
  • MA - Manager
  • RE - Reviewer
  • AN - Annotator
  • DI - Deactivated
  • NO - Not Activated
  • VO - View Only
email_notification_settingsobject required

Get email notification settings with default values for all notification types.

Returns a dictionary with the following structure: { 'notifications_allowed': { 'notification_type': bool }, 'notification_types': [ {'value': str, 'label': str} ] }

Excludes blocklisted notification types and ensures all valid types are included with proper defaults for any missing types.

When organization's email_notification_settings is null or empty, all notifications are shown as enabled (True) by default. When organization has some settings, unconfigured notifications default to False.

embed_domainsunknown
embed_enabledboolean nullable

Enable embed functionality for this organization

embed_settingsunknown
external_idstring nullable

External ID to uniquely identify this organization

idinteger required
interface_settingsunknown
react_code_settingsobject required
titlestring required
tokenstring required

Changes

  • 62c0a4fd4e2bRevision changes
    • info

      added the required property to the response with the status

  • d61bc77f80bcRevision changes
    • warning

      added the new VO enum value to the //// response property for the response status