Developer quickstart

1. Create a store, no signup needed

No account and no body required. You get an API key and a claim link for the store owner.

curl -X POST https://www.recircleos.com/api/v1/anonymous

{
  "store_id": "6db9a069-…",
  "api_key": "re_dev_…",
  "claim_id": "claim_…",
  "claim_url": "https://www.recircleos.com/claim/claim_…",
  "expires_at": "…",            // 14 days, unless claimed
  "limits": { … },
  "elicitations": [             // optional: pre-fill the claim form
    { "id": "owner_email", "required_at": "claim", … }
  ]
}

2. Set the store up and bring its data in

It's the same API a claimed store uses. Moving a store off a spreadsheet or another system is ordinary calls, consignors first and then items, following the migration guide (also served to agents as SKILL.md).

curl -X POST https://www.recircleos.com/api/v1/items \
  -H "Authorization: Bearer re_dev_…" \
  -H "Content-Type: application/json" \
  -d '{ "sku": "1001", "title": "Silk Dress", "tag_price": 4500, "quantity": 1, "account": "<consignor id>" }'

3. Hand the owner the claim link

When the owner wants the dashboard, or a limit answers 402 sandbox_claim_required with the claim_url, send them the link. They sign up with an email they confirm, the store becomes theirs, and your key keeps working.

Treat the claim link like a secret: whoever opens it first and confirms their email becomes the owner.

Limits before a store is claimed

A limit answers 402 with the claim link. Reads, updates and deletes keep working. Once claimed, the store is on the free plan; a paid plan for bigger stores is coming soon.

• 1,000 API calls per day
• 100 active items and 50 consignors
• 10 finalized sales
• Deleted after 14 days if unclaimed

Open API reference