Skip to main content
Bucket routes use an ECS API key with the permission shown for each operation.

​
Bucket names

Names must:
  • Be 2 to 63 characters.
  • Use lowercase letters, numbers, and hyphens.
  • Start and end with a letter or number.
  • Be unique within your account.
Valid examples include user-uploads, media-assets, and backup-2026.

​
Create a bucket

POST /clearlake/buckets requires clearlake:write:
visibility defaults to private. Use public for assets that may be served without private access controls. Visibility cannot be changed after creation. To change it, create a new bucket and move the objects.

​
List and inspect

  • GET /clearlake/buckets requires clearlake:read and returns { "buckets": [...] }.
  • GET /clearlake/buckets/:name requires clearlake:read and returns one bucket.
Use the bucket name from the response in later object routes.

​
Delete a bucket

DELETE /clearlake/buckets/:name requires clearlake:delete and returns 204 No Content. Deleting a bucket is permanent and removes its contents. Confirm the bucket name before issuing the request.

​
Choosing visibility