KHkhotan
Buckets

Issue bucket credentials

Issues a folder-scoped API key for the bucket and returns its secret once. The key acts only through the Files API and only within the bucket's folder subtree — send it as Authorization: Bearer against the Files API. Each call rotates the credential: any previously issued key for this bucket is revoked. The secret is shown once and is not retrievable afterward. The response filesApiBaseUrl already includes /api/v1 — append paths such as /files/... directly; do not append another /api/v1.

post/api/v1/buckets/{bucketId}/credentials

Request

  • Base URL
    https://app.khotan.com
  • URL
    https://app.khotan.com/api/v1/buckets/{bucketId}/credentials
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Path parameters

bucketIdstring required

Response

The issued bucket credential (secret shown once).

apiKeystring required

The API key secret. Send it as Authorization: Bearer <apiKey> to the Files API. Shown once — store it now; rotate to replace it.

keyIdstring required
prefixstring nullable required
filesApiBaseUrlstring required

Base URL for the Files API this key is authorized against. Already includes the /api/v1 prefix — append resource paths such as /files/... directly. Do not append another /api/v1.

Changes

No recorded changes to this operation across all 1 revision of this API.