Public — Invitations
Recipient-facing network invitation accept (magic-link token)
Resolve an invitation token into the context needed to render the accept screen
Public endpoint authenticated solely by the opaque magic-link token in the path — no API key is required. Returns the curated details needed to render the accept page: the network name, the assigned role, the invitation status and expiry, whether the recipient has passed email-code verification, and the invited email with its local part masked so the token alone does not reveal the full address.
Accept the invitation (after code verification); the invitee is enrolled as a member
Public, token-authenticated final step that accepts the invitation and enrolls the recipient as an active network member in the invited role. It resolves the invitee to a user record by the invited email (creating one if none exists) and keys the membership to it. Requires that the emailed code has already been verified, otherwise returns 409. The operation is idempotent for concurrent or repeated accepts and emits an invitation.accepted webhook to the network.
Email a verification code to the invited address
Public, token-authenticated action that generates a numeric verification code and emails it to the invited address, proving the recipient controls that mailbox; it must be submitted to verify-code before the invitation can be accepted. The email send is best-effort — the code is stored even if delivery fails. Keyless callers are rate limited per token and per client IP; exceeding the limit returns 429 with a Retry-After hint. A valid API key for the network bypasses the rate limit.
Submit the verification code
Public, token-authenticated step that checks the numeric code previously emailed via send-code. Verification must succeed before the invitation can be accepted. Attempts are rate limited per token and per client IP, and the code locks out after too many incorrect tries — both cases return 429, after which the recipient must request a fresh code. An expired or never-sent code returns 409.