SteadyLink

Buckets

Buckets are workspace-level containers for files and folders. Their settings define default visibility, upload policy, and delivery behavior.

GET/api/assets/
200 OK

List buckets in the active workspace using cursor pagination.

Required scopeassets:read

Query parameters

NameTypeDescription
limitinteger

Number of buckets to return. Minimum 1, maximum 100, default 20.

cursorISO datetime

The nextCursor value from the previous response.

Response
{
  "items": [{
    "id": "bucket_uuid",
    "name": "Marketing",
    "slug": "marketing",
    "createdAt": "2026-08-17T18:31:00",
    "isPrivate": false
  }],
  "nextCursor": "2026-08-17T18:31:00"
}
POST/api/assets/
200 OK

Create a bucket in the active workspace.

Required scopeassets:write
Request body
{
  "name": "Product media",
  "slug": "product-media"
}
Response
{ "id": "bucket_uuid" }
GET/api/assets/{bucket_id}
200 OK

Read bucket identity, privacy, and settings.

Required scopeassets:read
DELETE/api/assets/{bucket_id}
200 OK

Delete the bucket, its object links, retained revision bytes, transform records, and storage markers. This operation cannot be undone.

Required scopeassets:write
Deletion is immediate. There is no restore endpoint or soft-delete window.

Need another path?

Open dashboardRead engineering notes