Skip to content
Last updated

Complete the invitation by registering the user and returning authentication tokens.

POST/v1/invitations/complete

This is an atomic operation that validates the invitation, creates/updates the user account, activates organization membership, and returns JWT tokens for immediate login.

email_key string required

Invitation key from the URL (invkey_ prefixed).

full_name string required

User's full name (1-255 characters).

password string required

User's password (minimum 8 characters).

Returns

Returns authentication tokens for immediate login.

Notes

  • Public endpoint used during registration flow
  • Atomic operation: validates invitation, creates user, and returns tokens
  • User is immediately logged in after successful completion
  • Invitation is marked as used and cannot be reused

Authorization

None (Public endpoint)

Bash
curl -X POST https://api.aitronos.com/v1/invitations/complete \
  -H "Content-Type: application/json" \
  -d '{
    "email_key": "invkey_f87d706d08504aacb5fec46316ce5f23",
    "full_name": "John Doe",
    "password": "SecurePass123!"
  }'

Response:

{
  "success": true,
  "user_id": "usr_abc123",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": {
    "token": "refresh_token_xyz789...",
    "expires_at": "2026-02-06T10:30:00Z"
  },
  "device_id": null
}