Tolgee Octri Demo
POST/v2/projects/{projectId}/content-storages/{id}/test

Test existing content storage settings

Tests new settings for an existing content storage configuration. Supply the storage identifier and the settings to test; null secret values use the existing secrets. A 200 response reports whether the test succeeded and can include a message.

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

2 parameters · 4 body fields
idintegerrequired
The numeric identifier of the existing content storage to test.
projectIdintegerrequired
The numeric identifier of the project containing the content storage.

The updated content storage settings to test. Null secret values use the existing secrets.

azureContentStorageConfigobjectoptional
Azure storage settings, including the required `containerName` and optional `connectionString`.
namestringrequired
The content storage name. Must be no more than 100 characters.
publicUrlPrefixstringoptional
The public URL prefix for stored content. Must be no more than 255 characters.
s3ContentStorageConfigobjectoptional
S3-compatible storage settings. `bucketName`, `endpoint`, `path`, `publicRead`, and `signingRegion` are required; `accessKey` and `secretKey` are also available.

5 status codes
200Returns a result containing a `success` boolean and, when available, a message describing the test outcome.
messagestringoptional
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
successbooleanrequired
400Returned when the request body is invalid or a required field or nested provider setting is missing.
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 test the content storage settings.
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 project or content storage does not exist.
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 when authentication is missing or invalid, a 403 when access is forbidden, and a 404 when the project or content storage is not found. name is required; containerName is required in azureContentStorageConfig, and bucketName, endpoint, path, publicRead, and signingRegion are required in s3ContentStorageConfig. The id and projectId path parameters must identify a content storage belonging to the specified project.