Invitations

Manage organization invitations

get

List organization invitations. Requires the 'invitations:read' scope.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Query parameters

limitnumber · min: 1 · max: 1000Optional

The number of results to return

Default: 100

offsetnumberOptional

The number of results to skip

Default: 0

statusstring · enumOptional

The status of the invitations to list

Possible values:

includeExpiredbooleanOptional

Whether to include expired invitations in the list

Default: false

Responses

200

Response for status 200

application/json

limitnumberRequired

offsetnumberRequired

totalCountnumberRequired

500

An unknown error occurred, trying again might help.

application/json

get

/v1/organization/invitations

HTTPcURLJavaScriptPython

GET /v1/organization/invitations HTTP/1.1
Host: api.tryopine.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "status": "PENDING",
      "role": "ADMIN",
      "id": 1,
      "createdAt": "2026-03-03T15:07:18.322Z",
      "updatedAt": "2026-03-03T15:07:18.322Z",
      "expiresAt": "2026-03-03T15:07:18.322Z",
      "inviterUserId": 1,
      "inviteeEmail": "text",
      "organizationId": 1
    }
  ],
  "limit": 1,
  "offset": 1,
  "totalCount": 1
}

Invite User

post

Invite a user to join an organization. Requires the 'invitations:write' scope.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Body

application/json

inviteeEmailstring · emailRequired

The email of the user to invite

rolestring · enumRequired

The role of the user to invite

Possible values:

Responses

200

Response for status 200

application/json

statusstring · enumRequiredPossible values:

rolestring · enumRequiredPossible values:

idintegerRequired

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

expiresAtstring · date-timeRequired

inviterUserIdinteger · nullableRequired

inviteeEmailstringRequired

organizationIdintegerRequired

500

An unknown error occurred, trying again might help.

application/json

post

/v1/organization/invitations

HTTPcURLJavaScriptPython

POST /v1/organization/invitations HTTP/1.1
Host: api.tryopine.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "inviteeEmail": "[email protected]",
  "role": "ADMIN"
}

{
  "status": "PENDING",
  "role": "ADMIN",
  "id": 1,
  "createdAt": "2026-03-03T15:07:18.322Z",
  "updatedAt": "2026-03-03T15:07:18.322Z",
  "expiresAt": "2026-03-03T15:07:18.322Z",
  "inviterUserId": 1,
  "inviteeEmail": "text",
  "organizationId": 1
}

Revoke Invitation

post

Revoke an invitation to join an organization. Requires the 'invitations:write' scope.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Path parameters

idnumber · min: 1Required

The ID of the invitation to revoke

Responses

200

Response for status 200

application/json

idnumberRequired

The ID of the invitation that was revoked

500

An unknown error occurred, trying again might help.

application/json

post

/v1/organization/invitations/{id}/revoke

HTTPcURLJavaScriptPython

POST /v1/organization/invitations/{id}/revoke HTTP/1.1
Host: api.tryopine.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "id": 1
}