Docs
OverviewGuidesZero & MCPAPI referenceChangelog
Invites

Accept Invite

Join the invite's workspace with its role (signed-in users; an API key gets 403). The invite is used up. 409 if you're already a member (the invite stays open). Rate-limited like the preview. To sign up and join in one step, send `invite_token` to `/auth/signup`.

API key access

Not available to API keys or connected apps: only a signed-in person can call this route.
POST/api/v1/invites/{token}/accept

Authorization

AuthorizationBearer <token>

Access token from /api/v1/auth/login, or an API key (ro_pat_..., RO-176) from /api/v1/workspaces/current/api-keys: the key implies its workspace and needs the route's scope. MCP connectors (/api/v1/mcp only) may use an OAuth access token (ro_oat_..., RO-284).

In: header

Path Parameters

tokenstring

Response Body

curl -X POST "http://localhost:8000/api/v1/invites/string/accept"
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "slug": "string",
  "plan": "free",
  "timezone": "string",
  "country": "string",
  "default_language": "string",
  "suspended_at": "2019-08-24T14:15:22Z",
  "suspended_reason": "string",
  "role": "owner"
}
Empty
Empty
Empty
Empty

Upload Leads Csv

Upload a CSV: detect encoding and delimiter, suggest a column mapping, preview 20 rows. Nothing is imported until `POST /imports/{id}/commit`.

Preview Invite

What an invite link offers (workspace, role, inviter), for the accept page. No authentication. An unknown, used, revoked or expired link is the same 404. Rate-limited per client IP (`INVITE_RATE_LIMIT_ATTEMPTS`, 429 with `Retry-After`).