POST/v2/organizations/{organizationId}/glossaries

Create an organization glossary

Creates a glossary for an organization with a base language and optional project assignments. Supply assignedProjectIds, baseLanguageTag, and name; the language tag must follow BCP 47 and cannot contain a comma.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
organizationIdintegerrequired
The integer identifier of the organization in which to create the glossary.

Glossary details and the project assignments to create.

assignedProjectIdsarray<integer>required
IDs of projects to be assigned to glossary
baseLanguageTagstringrequired
Language tag according to BCP 47 definition
namestringrequired
Glossary name

5 status codes
200Returns the created glossary, including its identifier, name, base language tag, and organization owner.
baseLanguageTagstringrequired
Language tag for default translations for terms
idintegerrequired
namestringrequired
organizationOwnerobjectrequired
400Returned when a required field is missing or a supplied value fails validation.
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 not authenticated.
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 the authenticated user does not have access to the requested resource.
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 indicates an invalid request; a 401 indicates missing or invalid authentication; a 403 indicates the authenticated user lacks access; and a 404 indicates the organization was not found. assignedProjectIds, baseLanguageTag, and name are required. The organizationId path parameter must be an integer.