Accept Namespace Invitation
accept_inviteIdempotent
Accept a namespace invitation addressed to THIS authenticated account's verified email (two-step email OTP).
Steps:
step='request' — emails a 6-digit code to the invited address (may return 402 needs Collaborator, or 503 if mailer fails).
step='confirm' with code= the 6 digits — activates the grant and returns mcp_config headers (X-Ctxstore-Workspace) for shared access.
The code activates the named grant_id only; it authorizes nothing else. Obtain grant_id from list_invites(). Docs: https://ctxstore.ai/docs.html#verify-invitations
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | 6-digit code from email (required when step=confirm). | |
| step | Yes | request = send OTP email; confirm = submit code. | |
| grant_id | Yes | UUID of the invitation (from list_invites or invite email). |