List an object's share links

Returns every share link over one object, newest first, each with its policy (hasPassword, maxUses, expiresAt, oneTime), live usesCount, and revoked flag.

Endpoint

GET https://api.dairo.app/v1/buckets/{bucketId}/objects/{objectId}/share-links

Returns every share link over one object, newest first, each with its policy (hasPassword, maxUses, expiresAt, oneTime), live usesCount, and revoked flag. The link URLs and tokens are not included — they are shown only once, at creation time. This list is not paginated. Requires buckets:read.

Scope: buckets:read. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

cURL

curl "https://api.dairo.app/v1/buckets/3fa85f64-5717-4562-b3fc-2c963f66afa6/objects/3fa85f64-5717-4562-b3fc-2c963f66afa6/share-links" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Path parameters

Name	Type	Required	Description
`bucketId`	string	yes	Bucket identifier (buk_*).
`objectId`	string (uuid)	yes	Storage object identifier.

Response

200 Success. Body: application/json, ShareLinkListResponse.

Field	Type	Required	Description
`object`	string	no
`data`	array of ShareLink	no

200

{
  "object": "list",
  "data": [
    {
      "object": "share_link",
      "id": "string",
      "objectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "shareUrl": "string",
      "downloadUrl": "string",
      "hasPassword": true,
      "maxUses": null,
      "oneTime": true,
      "usesCount": 0,
      "expiresAt": "2026-10-19T09:30:00Z",
      "revoked": true,
      "createdAt": "2026-10-19T09:30:00Z"
    }
  ]
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.

Status	Meaning
`400`	The request is malformed or a value is invalid (`invalid_request`, `invalid_domain`, `idempotency_key_mismatch`).
`401`	The API key is missing or invalid.
`403`	The key lacks the scope this endpoint needs (`scope_missing`) or may not do this (`not_permitted`).
`404`	No such resource in this account (`resource_not_found`).
`429`	Rate limit, plan limit, budget or spend cap reached (`rate_limited`, `plan_limit_reached`, `budget_exceeded`, `spend_cap_reached`).
`500`	An unexpected error; retry with backoff, then contact support (`internal_error`).

List an object's share links

Request

Path parameters

Response

Errors

On this page