Organizations

Last updated 6 months ago

Was this helpful?

Create Organization

Create a new organization for the current user.

post

/organizations

Authorizations

Body

namestring · min: 1 · max: 256required

Organization's display name.

slugstring · min: 1 · max: 253required

Organization's human-readable identifier.

Pattern: ^[a-zA-Z0-9-]+$

countryCodestring · iso3166-1required

The country in which the organization operates.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/organizations' \
  --header 'Authorization: Bearer jwt' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "slug": "text",
    "countryCode": "text"
  }'

201

409

422

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "slug": "text",
  "avatarUrl": "text",
  "status": "active",
  "statusReason": "text",
  "pendingMemberCount": 1,
  "activeMemberCount": 1,
  "owner": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-02-28T12:04:46.247Z",
  "updatedAt": "2025-02-28T12:04:46.247Z",
  "managedBy": [
    {
      "Type": "text",
      "ID": "text"
    }
  ]
}

Created

Get Organization

Get an organization by its ID.

get

/organizations/{organizationId}

Authorizations

Path parameters

organizationIdstringrequired

The organization ID

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/organizations/{organizationId}' \
  --header 'Authorization: Bearer jwt'

200

404

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "slug": "text",
  "avatarUrl": "text",
  "status": "active",
  "statusReason": "text",
  "pendingMemberCount": 1,
  "activeMemberCount": 1,
  "owner": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-02-28T12:04:46.247Z",
  "updatedAt": "2025-02-28T12:04:46.247Z",
  "managedBy": [
    {
      "Type": "text",
      "ID": "text"
    }
  ]
}

Update Organization

Update an organization's properties.

patch

/organizations/{organizationId}

Authorizations

Path parameters

organizationIdstringrequired

The organization ID

Body

namestring · min: 1 · max: 256

Organization's display name.

avatarUrlstring

The url of the avatar displayed next to the org

statusReasonstring | nullable

The reason for the organization's status

ownerstring · uuid

The organization's owner's ID

statusstring · enum | nullable

Options: banned, active

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PATCH \
  --url '/organizations/{organizationId}' \
  --header 'Authorization: Bearer jwt' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "avatarUrl": "text",
    "statusReason": "text",
    "owner": "123e4567-e89b-12d3-a456-426614174000",
    "status": "banned"
  }'

200

403

404

422

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "slug": "text",
  "avatarUrl": "text",
  "status": "active",
  "statusReason": "text",
  "pendingMemberCount": 1,
  "activeMemberCount": 1,
  "owner": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-02-28T12:04:46.247Z",
  "updatedAt": "2025-02-28T12:04:46.247Z",
  "managedBy": [
    {
      "Type": "text",
      "ID": "text"
    }
  ]
}