Skip to content
Last updated

Validate an invitation by email key. This endpoint is public and does not require authentication.

GET/v1/invitations/validate/{email_key}

email_key string required

Unique invitation key from the invitation link (format: invkey_ + 32 hex characters).

Returns

Returns invitation details if valid, including organization and role information.

Notes

  • Public endpoint used by the frontend registration flow
  • User clicks invitation link with email_key parameter
  • Frontend validates invitation before showing registration form
  • Returns error if invitation is expired or already used

Authorization

None (Public endpoint)

Bash
curl https://api.aitronos.com/v1/invitations/validate/invkey_f87d706d08504aacb5fec46316ce5f23

Response:

{
  "valid": true,
  "invitation_id": "inv_abc123def456",
  "email": "newuser@example.com",
  "organization_id": "org_xyz789",
  "organization_name": "Acme Corporation",
  "role_id": "role_member123",
  "role_name": "Member",
  "expires_at": "2026-01-12T19:15:12.638232Z"
}