Put Storage

PUT /storage

Role floor

Requires admin or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Request body — StorageWrite

Field	Type		Notes
endpoint	string	required	min length 9 max length 400
region	string	optional	Default "us-east-1". min length 1 max length 60
bucket	string	required	min length 3 max length 63
access_key_id	string	required	min length 1 max length 200
secret_key	string | null	optional	min length 1 max length 512

Responses

Status	Description	Body
200	Successful Response	StorageView
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

The body shows the fields the schema always carries. Which combination is legal is a service rule the schema cannot express, so read the description above before copying this.

curl -X PUT https://your-deployment.example.com/storage \
  -H "Authorization: Bearer $COBRE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
       "endpoint": "string",
       "bucket": "string",
       "access_key_id": "string"
     }'

Response — StorageView

Field	Type		Notes
configured	boolean	required	—
storage_id	string (uuid) | null	optional	—
endpoint	string | null	optional	—
region	string | null	optional	—
bucket	string | null	optional	—
access_key_id	string | null	optional	—
secret_set	boolean	optional	Default false.
usable	boolean	optional	Default true.
checked_at	string (date-time) | null	optional	—
failure_detail	string | null	optional	—
versioning	string | null	optional	—
updated_at	string (date-time) | null	optional	—