Agent quickstart

1. Create an anonymous workspace

Returns a store id, API key, and claim ID. Save the claim ID — you’ll need it to keep the workspace.

curl -X POST https://api.recircleos.com/v1/anonymous \
  -H "Content-Type: application/json"

{
  "store_id": "sto_tmp_…",
  "api_key": "rk_live_…",
  "claim_id": "claim_…",
  "expires_at": "…"
}

2. Call the API

Same shape as a claimed store. Money in cents, cursor lists, bearer auth.

curl https://api.recircleos.com/v1/items \
  -H "Authorization: Bearer rk_live_…"

{
  "data": [],
  "next_cursor": null
}

3. Claim when you’re ready

Sign up (or log in), then attach the claim ID. The anonymous workspace becomes your account — keys keep working.

curl -X POST https://api.recircleos.com/v1/claim \
  -H "Authorization: Bearer <session>" \
  -H "Content-Type: application/json" \
  -d '{ "claim_id": "claim_…" }'

Store your claim ID like a receipt. Anyone with it can claim the workspace — treat it like a secret.

Fair-use caps on anonymous workspaces

Anonymous keys are for evaluation. When you hit the cap, claim and sign up — so serious agent usage moves to a real account.

• Limited API calls per day
• Limited active items & finalized sales
• Keys expire if unclaimed
• No custom domain or production integrations until claimed

Open API reference