Create storage resource
Registered storage returns 201 with resource. Managed S3 Files returns 202 with storageId/status. Subject to rollout and provider prerequisites.
Requires every scope: storage:write.
Authentication
AuthorizationBearer
JWT returned by POST /api/auth/token-exchange. Amazon and authorization invitations require API-key-derived tokens.
Request
This endpoint expects an object.
RegisteredStorageCreate
Registered storage requires credentials except s3-files. s3 is normalized to s3-object. S3 Files requires the listed filesystem/access point and role metadata and an enabled organization.
OR
ManagedStorageCreate
Managed S3 Files provisioning is asynchronous and subject to provider and organization availability.
Response
Success
resource
Storage resource. Managed status can also be supplied beside the resource. Mode in persisted resource data can differ from the request label.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error
503
Service Unavailable Error