Skip to main content
User provisioning is a cloud-only feature available on all plans at app.buckle.dev.
User provisioning lets organization admins pre-create user accounts before the user signs up. Each provisioned user gets a workspace, API key, and a claim link. The API key works immediately, and the user can claim the account later.

How it works

  1. An admin provisions a new user through the API or the SDK
  2. Buckle creates a placeholder user, workspace, API key, and default agent
  3. The admin receives a claim link and API key
  4. The API key is usable immediately, so agents can start making requests
  5. When the user visits the claim link, they sign up and the account is linked to their identity
  6. Unclaimed provisions expire after 7 days and are automatically cleaned up
Provisioning is an API operation only. To add someone from the dashboard, invite them instead: open Settings > Members and click Invite.

Provisioning from the SDK

Requires an API key from an admin or owner account.

Parameters

Response

API endpoint

You can also call the API directly:

Claim flow

When a provisioned user visits the claim link:
  1. If not signed in, they’re prompted to sign up or log in
  2. After authentication, they see a confirmation page with the organization name
  3. Clicking Claim account links their identity to the provisioned account
  4. They’re redirected to the dashboard with the provisioned org as their active context
If the user already has a Buckle account, the provisioned workspace is transferred to their existing account.

Expiry and cleanup

  • Unclaimed provisions expire after 7 days
  • Expired provisions are automatically cleaned up (placeholder user, project, API key, and agent are deleted)
  • Cancelled provisions are cleaned up immediately
The API key works immediately after provisioning. You don’t need to wait for the user to claim the account. This lets you configure agents before the user even signs up.