Claim a sandbox into your account
Agent Sandbox
Claim a Sandbox
Fold a provisional sandbox — its order history and its API key — into a real Zinc account without breaking the agent that created it.
POST
Claim a sandbox into your account
Folds a provisional sandbox into the authenticated account. This is what the
claim_url from the mint response leads to: a human signs in, and the agent’s sandbox becomes part of their Zinc account.
Claiming is always a merge — signing in creates the account if it didn’t exist, so by the time this endpoint runs there is always a real account to merge into.
What moves
The response reports the counts (
orders_moved, keys_moved) plus a human-readable message.
Not revoking the key is the whole point of claiming rather than starting over. An agent that has been running against a sandbox for a week doesn’t need redeployment to keep going.
Errors
After claiming
A claimed key still only reaches the sandbox. To place real orders, the account owner mints azn_live_ key in the dashboard and funds a wallet. The agent can confirm the claim landed with GET /sandbox/status.Authorizations
Zinc API key (Bearer zn_...)
Headers
Body
application/json
The raw claim token from a claim URL.
Required string length:
1 - 128
