Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

List bucket keys

GET/v1/buckets/{bucketId}/keysList bucket keys

Returns all access keys for the given bucket.

Parameters

bucketIdstringpathrequired

pattern ^(bkt_)?([cC][^\s-]{8,}|[a-z0-9]+)$

cursornull | stringquery

Cursor for pagination

limitintegerquery

Page size, 1-100

default 100 · maximum 100 · minimum 1

Responses

200Returns the list of bucket keys.application/json
object
dataarray of objectrequired
Show child attributes
Show array items
createdAtstring · date-timerequired
idstringrequired

pattern ^(bkey_)([cC][^\s-]{8,}|[a-z0-9]+)$

namestringrequired
rolestringrequired

one of "read", "read_write"

typestringrequired

const "bucketKey"

valueHintstringrequired
paginationobjectrequired
Show child attributes
hasMorebooleanrequired

Whether there are more items to paginate

nextCursornull | stringrequired

Next cursor to continue pagination

Example response
{
  "data": [
    {
      "createdAt": "2026-06-09T00:00:00Z",
      "id": "string",
      "name": "string",
      "role": "read",
      "type": "bucketKey",
      "valueHint": "string"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "string"
  }
}
401Missing or invalid authorization token.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
404Bucket with the given ID was not found.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
413Request body exceeds this endpoint's size cap.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
Documentation menu