---
title: "Mint a FRESH single-use claim URL for this trial workspace, invalidating the previous one. For an agent that lost the claim_url returned at bootstrap (hosted agents lose their files between sessions). Works while the workspace is read-only; requires no capability and creates no authority. 409 NOT_PROVISIONAL for a normal workspace, 409 ALREADY_CLAIMED once a human owns it."
method: POST
path: "/claim-link"
---

# Mint a FRESH single-use claim URL for this trial workspace, invalidating the previous one. For an agent that lost the claim_url returned at bootstrap (hosted agents lose their files between sessions). Works while the workspace is read-only; requires no capability and creates no authority. 409 NOT_PROVISIONAL for a normal workspace, 409 ALREADY_CLAIMED once a human owns it.

`POST /claim-link`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/claim-link`
- Auth: HTTP bearer

## Response `200`

ProvisionalClaimLink

- object
  - `handoff` object
    - `api_base` string
    - `openapi` string
    - `llms` string
    - `token_exchange` string: How to use the credential: fbzr_ credentials are exchanged at POST /identity/token for an access_token; any other credential is used as the bearer directly.
    - `first_calls` string[]: Always ["GET /me", "GET /next"].
    - `continue_a_commitment` string
  - `claim_url` string
  - `claim_code` string
  - `claim_deadline` string, nullable
  - `single_use` boolean
  - `previous_link_invalidated` boolean
  - `rotations` integer
  - `summary` object: Forbiz-computed summary of what this workspace holds (counts of actions, evidence, decisions and outcomes), so the agent can tell the owner what it is receiving.
  - `suggested_message` string: A ready-to-send message for the human owner, capped at 599 characters.
  - `note` string

## Other responses

- `409`: NOT_PROVISIONAL or ALREADY_CLAIMED

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)