Accept an invitation, as the person signed in
Send the code from the invitation email with a PERSON's access token (no X-Organization: you are not a member yet). The email of your account is read from the identity provider: it must be verified, and it must be the invited address. The answer carries the id of the organization you now belong to: send it in X-Organization from here on. Codes presented here and to POST /v1/invitations/inspect share one budget per person (limits.invitation_codes_per_person in GET /v1).
POST
https://api.invox.page/v1/invitations/acceptAuthorization
Request body JSON required
Returns
200
The organization the person now belongs to, and their membership.
JSON
400
validation_failed: The request is not valid · malformed_request: The request body is not valid JSON
JSON
401
unauthenticated: No credential was sent · invalid_credential: The credential is not valid
JSON
403
person_credential_required: This route is for a person, not for a service account · email_not_verified: The email of this person is not verified · invitation_email_mismatch: The invitation was sent to another email address · organization_archived: The organization is archived
JSON
404
invitation_not_found: The invitation does not exist, was revoked or was already used
JSON
409
invitation_expired: The invitation expired
JSON
429
rate_limited: Too many requests
JSON
500
internal_error: The service failed
JSON
503
service_unavailable: The service cannot answer right now
JSON