Skip to content
/
Get invitation
Last updated

Retrieve details of a pending invitation including the shareable invitation link.

GET/v1/organizations/{organization_id}/invitation

Path Parameters

organization_id string required

Organization ID

Query Parameters

Provide exactly one of the following:

email string optional

Email address of the invited user.

user_id string optional

User ID of the invited user (usr_ prefixed).

invitation_id string optional

Invitation ID (inv_ prefixed).

Returns

Returns the invitation object with the shareable link.

Authorization

Requires organization membership.

Bash
# By email
curl -X GET "https://api.aitronos.com/v1/organizations/org_abc123/invitation?email=user@example.com" \
  -H "X-API-Key: $FREDDY_API_KEY"

# By user_id
curl -X GET "https://api.aitronos.com/v1/organizations/org_abc123/invitation?user_id=usr_xyz789" \
  -H "X-API-Key: $FREDDY_API_KEY"

# By invitation_id
curl -X GET "https://api.aitronos.com/v1/organizations/org_abc123/invitation?invitation_id=inv_def456" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

{
  "invitation_id": "inv_def456",
  "email": "user@example.com",
  "user_id": "usr_xyz789",
  "organization_id": "org_abc123",
  "role_id": "role_jkl012",
  "invitation_link": "https://chat.aitronos.com/user/register?invite=abc123...",
  "expires_at": "2026-01-12T10:30:00Z",
  "created_at": "2026-01-05T10:30:00Z"
}
Previous page
Next page