BucktDocs

Retry bucket provisioning

POST/v1/buckets/{id}/retrybuckets:writeSDK: buckets.retry

Resets a failed bucket back to pending and re-queues provisioning. Use this after fixing the underlying cause of a failure (e.g. correcting DNS records or verifying ownership of a connected AWS account).

The response confirms the bucket's id — call Get bucket to track the new provisioning attempt.

Path parameters

NameTypeDefaultDescription
idrequiredstring—The bucket ID to retry. Must be in `failed` status.

Example request

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

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

await client.buckets.retry("bkt_01H8XYZABCDEFGHJKMNPQRSTVW");
// Returns: { object: "bucket", id: "bkt_01H8XYZABCDEFGHJKMNPQRSTVW" }
// The bucket is back to "pending" — fetch it to track progress.

Responses

{
  "data": {
    "object": "bucket",
    "id": "bkt_01H8XYZABCDEFGHJKMNPQRSTVW"
  },
  "error": null,
  "meta": null
}