BucktDocs

Get key

GET/v1/keys/{id}keys:readSDK: keys.get

Returns the full detail for an API key: the List keys summary plus permissions, bucketIds, and expiresAt. The raw key is never returned — only on the original Create key response.

Path parameters

NameTypeDefaultDescription
idrequiredstring—The API key's ID (not the secret value itself).

Example request

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

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

const key = await client.keys.get("key_01J5UPLOADERXXXXXXXXXXXXXX");

Responses

{
  "data": {
    "object": "api_key",
    "id": "key_01J5UPLOADERXXXXXXXXXXXXXX",
    "name": "Production uploader",
    "prefix": "bkt_xY9z",
    "permissions": ["buckets:read", "files:read", "files:write"],
    "bucketIds": ["bkt_01H8XYZABCDEFGHJKMNPQRSTVW"],
    "lastUsedAt": "2026-04-25T11:42:00Z",
    "expiresAt": "2027-01-01T00:00:00Z",
    "createdAt": "2026-04-20T10:00:00Z"
  },
  "error": null,
  "meta": null
}