API reference · Invitations
Accept an invitation addressed to your verified email
/v1/orgs/{org_id}/invitations/{invitation_id}/acceptMakes you a member of the organization with the role the invitation names, and returns the new membership. An invitation addressed to someone else answers 404.
Console session only. The console calls this with a signed-in session; API keys are refused.
Request
Path parameters
org_idstringYour organization. The SDKs and the CLI fill it in from the API key.
ID with prefix org_
invitation_idstringrequiredID of the invitation
ID with prefix inv_
Response
200 Member — Your new membership
objectstringrequiredAlways `member`: the type of this object
One of
memberidstringrequiredUnique ID (`mem_…`)
ID with prefix mem_
org_idstringrequiredOrganization it belongs to
ID with prefix org_
user_idstringrequiredID of the user
ID with prefix usr_
One of
owneradmindeveloperbillingvieweruserobjectrequiredThe user who holds this membership
ShowHide 3 fields of
usernamestringrequiredIts name
emailstringrequiredEmail address of the user
imagestring | nullrequiredContainer image reference
created_atstring (date-time)requiredWhen it was created (ISO 8601, UTC)
Example response
{
"object": "member",
"id": "mem_01jc5zq4m8k3v6x9t2w7r0b1e4",
"org_id": "org_01jc5zq4m8k3v6x9t2w7r0b1e4",
"user_id": "usr_01jc5zq4m8k3v6x9t2w7r0b1e4",
"role": "owner",
"user": {
"name": "string",
"email": "string",
"image": "string"
},
"created_at": "2026-01-01T00:00:00.000Z"
}Errors
Errors use the standard envelope. What this operation can answer:
| Status | Type | When |
|---|---|---|
400 | invalid_request_error | A parameter or body field is missing or not allowed; param names it. |
401 | authentication_error | The key or session is missing, revoked or expired. |
403 | permission_error | The credential lacks the permission this needs, or the organization is suspended. |
404 | not_found_error | No such resource in this project (an ID from another project is answered the same way). |
409 | conflict_error | The resource's current state does not allow this. |
429 | rate_limit_error rate_limited | Too many requests; retry after retry-after seconds. |