List keys

GET/v1/keyskeys:readSDK: keys.list

Returns a summary for every API key in the organization: id, name, prefix, lastUsedAt, createdAt. The raw key is never included — only the 8-character prefix so you can recognize a key without exposing it. Use Get key to read the full detail (permissions, bucketIds, expiresAt).

Query parameters

Name	Type	Default	Description
cursor	string	—	Pagination cursor returned in `meta.nextCursor` from a previous request.
limit	number	20	Page size. Range 1–100.

Example request

import { Buckt } from "@buckt/sdk";

const client = new Buckt({ apiKey: process.env.BUCKT_API_KEY });

const { data, meta } = await client.keys.list({ limit: 50 });

Responses

{
  "data": [
    {
      "object": "api_key",
      "id": "key_01J5UPLOADERXXXXXXXXXXXXXX",
      "name": "Production uploader",
      "prefix": "bkt_xY9z",
      "lastUsedAt": "2026-04-25T11:42:00Z",
      "createdAt": "2026-04-20T10:00:00Z"
    },
    {
      "object": "api_key",
      "id": "key_01J5READONLYYYYYYYYYYYYYYY",
      "name": "Public read-only",
      "prefix": "bkt_aB3c",
      "lastUsedAt": null,
      "createdAt": "2026-04-22T08:15:00Z"
    }
  ],
  "error": null,
  "meta": {
    "nextCursor": null,
    "limit": 50
  }
}