Tolgee Octri Demo
PUT/v2/organizations/{id}

Update organization data

Replaces an organization's data using the supplied organization details. Supply name; you can also provide a description and slug, subject to their schema constraints. A 200 response returns the updated organization details.

1 parameter · 3 body fields
idintegerrequired
The int64 numeric identifier of the organization to update.

Organization details to save.

descriptionstringoptional
A description of the organization.
namestringrequired
The organization name. Must be between 3 and 50 characters.
slugstringoptional
The organization slug. Must be between 3 and 60 characters and contain lowercase letters, digits, or hyphens, with at least one lowercase letter.

5 status codes
200Returns the updated organization, including its ID, name, slug, description, base permissions, and current user's organization role.
avatarobjectoptional
basePermissionsobjectrequired
currentUserRolestringoptional
The role of currently authorized user. Can be null when user has direct access to one of the projects owned by the organization.
Allowed:MEMBEROWNERMAINTAINER
descriptionstringoptional
idintegerrequired
namestringrequired
slugstringrequired
400Returned when `name` is missing or a field value fails validation, such as an invalid name length or slug.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
401Returned when the request is unauthenticated.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
403Returned when access is forbidden.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
404Returned when the organization is not found.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional

Error handling

A 400 is returned when name is missing or invalid, or when slug fails its length or character constraints. The id path parameter must identify the organization to update. A 401 indicates an unauthenticated request, a 403 indicates access is forbidden, and a 404 indicates the organization was not found.