Sign in

v76

OpenAPI 3.0.3raw.githubusercontent.com2026-08-015764591.5 MB
Organizations

✨ Update organization

<Card href="https://humansignal.com/goenterprise"> <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/> <p style="margin-top: 10px; font-size: 14px;"> This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise) </p> </Card> Update organization details including title, embed domains, and Plugins settings.
patch/api/organizations/{id}

Path parameters

idinteger required

Request body

contact_infostring email nullable
created_byinteger nullable
custom_interfaces_enabledboolean

Enable or disable custom interfaces for this organization

custom_scripts_enabledboolean nullable

Plugins

{"stackTrail":"components:schemas:PatchedLseOrganizationSerializerUpdateRequest:properties:email_notification_settings","oasType":"schema","type":"unknown","description":"Email Notification Settings","nullable":true}
embed_domainsobject[] nullable

Supported domains

embed_enabledboolean

Enable or disable embed functionality for this organization

{"stackTrail":"components:schemas:PatchedLseOrganizationSerializerUpdateRequest:properties:embed_settings","oasType":"schema","type":"unknown","description":"Public Verification Key and Public Verification Algorithms configuration","nullable":true}
{"stackTrail":"components:schemas:PatchedLseOrganizationSerializerUpdateRequest:properties:interface_settings","oasType":"schema","type":"unknown","description":"Security settings for custom interfaces: CSP allowlists, script origins, iframe permissions","nullable":true}
{"stackTrail":"components:schemas:PatchedLseOrganizationSerializerUpdateRequest:properties:react_code_settings","oasType":"schema","type":"unknown","description":"ReactCode settings","nullable":true}
titlestring nullable

Organization name

tokenstring nullable

Response

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.

{"stackTrail":"components:schemas:LseOrganization:properties:embed_domains","oasType":"schema","type":"unknown","description":"List of objects: {\"domain\": \"example.com\"}. Used for CSP header on /embed routes.","nullable":true}
embed_enabledboolean nullable

Enable embed functionality for this organization

{"stackTrail":"components:schemas:LseOrganization:properties:embed_settings","oasType":"schema","type":"unknown","description":"Embed settings for this organization","nullable":true}
external_idstring nullable

External ID to uniquely identify this organization

idinteger required
{"stackTrail":"components:schemas:LseOrganization:properties:interface_settings","oasType":"schema","type":"unknown","description":"Security settings for custom interfaces: CSP allowlists, script origins, iframe permissions.","nullable":true}
react_code_settingsobject required
titlestring required
tokenstring required