POST/s3-storages

Create S3 Storage

Create a new S3 storage configuration for the authenticated team.

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

8 body fields

S3 storage details

bucketstringrequired
S3 bucket name.
descriptionstringoptional
Optional description.
endpointstringrequired
S3-compatible endpoint URL.
is_usablebooleanoptional
Whether the storage is marked usable.
keystringrequired
Access key.
namestringrequired
A friendly name for the storage.
regionstringrequired
S3 region.
secretstringrequired
Secret key.

4 status codes
201S3 storage created.
uuidstringoptional
The UUID of the S3 storage.
400Invalid token.
messagestringoptional
401Unauthenticated.
messagestringoptional
422Validation error.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned: Invalid token. A 401 is returned: Unauthenticated. A 422 is returned: Validation error.