Tolgee Octri Demo
PUT/v2/organizations/{organizationId}/llm-providers/{providerId}

Replace an organization-specific provider configuration

Replaces an organization-specific language-model provider's configuration. Supply apiUrl, name, and type with each request; type must be one of the supported provider types, and optional string fields have schema-defined maximum lengths. A 200 response returns the updated provider configuration.

2 parameters · 10 body fields
organizationIdintegerrequired
The int64 identifier of the organization that owns the provider.
providerIdintegerrequired
The int64 identifier of the provider configuration to replace.

Replacement configuration for the organization-specific provider. apiUrl, name, and type are required.

apiKeystringoptional
The provider API key; maximum 511 characters.
apiUrlstringrequired
The provider API URL; maximum 2047 characters.
deploymentstringoptional
The provider deployment value; maximum 255 characters.
formatstringoptional
The provider format value; maximum 255 characters.
keepAlivestringoptional
The provider keep-alive value; maximum 255 characters.
modelstringoptional
The provider model value; maximum 255 characters.
namestringrequired
The provider's name; maximum 255 characters.
prioritystringoptional
Provider priority: LOW or HIGH.
Allowed:LOWHIGH
reasoningEffortstringoptional
The provider reasoning-effort value; maximum 255 characters.
typestringrequired
Provider type: OPENAI, OPENAI_AZURE, TOLGEE, ANTHROPIC, or GOOGLE_AI.
Allowed:OPENAIOPENAI_AZURETOLGEEANTHROPICGOOGLE_AI

5 status codes
200Returns the updated provider configuration, including its identifier, name, type, API URL, and configured provider settings.
apiKeystringoptional
apiUrlstringoptional
deploymentstringoptional
formatstringoptional
idintegerrequired
modelstringoptional
namestringrequired
prioritystringoptional
Allowed:LOWHIGH
reasoningEffortstringoptional
typestringrequired
Allowed:OPENAIOPENAI_AZURETOLGEEANTHROPICGOOGLE_AI
400Returned when the request body is invalid, including when required fields are missing or an enum value is not accepted.
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 the authenticated user is not permitted to update the provider.
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 specified organization or provider cannot be 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 the request is invalid. A 401 is returned when the request is unauthenticated, a 403 when the authenticated user cannot manage providers for the organization, and a 404 when the organization or provider cannot be found. apiUrl, name, and type are required; type must be one of OPENAI, OPENAI_AZURE, TOLGEE, ANTHROPIC, or GOOGLE_AI, and priority must be LOW or HIGH when supplied. The organizationId and providerId path parameters must identify the organization and provider to update.