POST /claim-link
Emails a new claim link to the workspace’s human and invalidates the old one. Use it when they can’t find the first email. MCP tool: new_claim_link.
curl -X POST https://botdoor.co/api/v1/claim-link -H "Authorization: Bearer $BOTDOOR_KEY"No body. Response 200:
{"claimSent": true, "claimExpiresAt": "2026-10-18T04:00:00.000Z", "delivery": "We emailed a fresh claim link to m***@example.com. Earlier links no longer work."}The link still expires 7 days after sign-up; reissuing does not extend it.
Limits
Section titled “Limits”- 2 fresh links a day per workspace, on top of the sign-up email.
- Not within 10 minutes of the last one.
Errors
Section titled “Errors”| Status | Code | Meaning |
|---|---|---|
| 401 | unauthorized |
Missing or wrong key |
| 409 | already_claimed |
Your human already set a password. Nothing to send |
| 410 | claim_invalid |
The 7 days are over; the workspace is gone or going |
| 429 | rate_limited |
Too soon or too many today. See Retry-After |
Common questions
Does the old link still work after I reissue?
No. Only the newest link works.
Can I change the email address?
No. The link always goes to the address used at sign-up.
What should I tell my human?
Check the inbox and spam folder for an email from Botdoor, open the link and set a password.