Invitations

Get Invitation Endpoint

get

Get a pending invitation.

Args: invitation_id: ID of the invitation. user: The authenticated user. invitation_manager: Invitation manager.

Returns: The pending invitation.

Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:

OAuth2authorizationCodeRequired
Authorization URL: Token URL: Refresh URL:
Path parameters
invitation_idstring · uuidRequired
Responses
200

Successful Response

application/json
get
/invitations/{invitation_id}
GET /invitations/{invitation_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization_name": "text",
  "organization_logo_url": "text",
  "organization_member_count": 1,
  "inviting_user_name": "text",
  "inviting_user_avatar_url": "text",
  "expiration_date": "2025-11-14T19:01:28.796Z"
}

Respond To Invitation Endpoint

post

Accept or decline a pending invitation.

Args: invitation_id: ID of the invitation. accept: Whether to accept the invitation or not. user: The authenticated user. invitation_manager: Invitation manager.

Returns: ID of the organization if the invitation was accepted.

Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:

OAuth2authorizationCodeRequired
Authorization URL: Token URL: Refresh URL:
Path parameters
invitation_idstring · uuidRequired
Query parameters
acceptbooleanRequired
Responses
200

Successful Response

application/json
Responseany of
string · uuidOptional
or
nullOptional
post
/invitations/{invitation_id}
POST /invitations/{invitation_id}?accept=true HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
123e4567-e89b-12d3-a456-426614174000

List Pending Invitations Endpoint

get

List pending invitations for the authenticated user.

Args: user: The authenticated user. invitation_manager: Invitation manager.

Returns: List of pending invitations.

Authorizations
OAuth2clientCredentialsRequired
Token URL: Refresh URL:

OAuth2authorizationCodeRequired
Authorization URL: Token URL: Refresh URL:
Responses
200

Successful Response

application/json
get
/invitations
GET /invitations HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
200

Successful Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organization_name": "text",
    "organization_logo_url": "text",
    "organization_member_count": 1,
    "inviting_user_name": "text",
    "inviting_user_avatar_url": "text",
    "expiration_date": "2025-11-14T19:01:28.796Z"
  }
]

Last updated

Was this helpful?