GitHubStart free

Organizations

List Organizations Endpoint

get

Endpoint to list organizations.

Args: name: Filter by organization name. offset: Query offset. limit: Query limit. auth_context: The authentication context. rbac: RBAC component. organization_manager: Organization manager owner_id: Id of the Organization owner

Returns: List of organization models.

Authorizations
Query parameters
nameany ofOptional
stringOptional
or
nullOptional
offsetintegerOptionalDefault: 0
limitintegerOptionalDefault: 100
owner_idany ofOptional
string · uuidOptional
or
nullOptional
Responses
200
Successful Response
application/json
get
GET /organizations HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "name": "text",
    "description": "text",
    "logo_url": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "created": "2025-07-19T14:26:05.721Z",
    "updated": "2025-07-19T14:26:05.721Z",
    "owner": {
      "password": "text",
      "password_expired": true,
      "name": "text",
      "avatar_url": "text",
      "company": "text",
      "job_title": "text",
      "metadata": {},
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text",
      "email": "text",
      "oauth_provider": "text",
      "oauth_id": "text",
      "is_active": true,
      "is_superuser": false,
      "is_service_account": false,
      "organization_id": "123e4567-e89b-12d3-a456-426614174000",
      "is_onboarded": false
    },
    "has_active_subscription": true,
    "trial_expiry": 1
  }
]

Create Organization Endpoint

post

Endpoint to create an organization.

Args: organization: The organization to create. user: The authenticated user. rbac: RBAC component. organization_manager: Organization manager

Raises: IllegalOperationError: If the user is not allowed to create an organization for another user or to set sensitive user fields. Also raised if the user is a service account. OrganizationLimitExceeded: If the user already has an organization.

Returns: Model of the created organization.

Authorizations
Body

Model for creating organizations.

idany ofOptional
string · uuidOptional
or
nullOptional
namestring · min: 1 · max: 50Required
descriptionany ofOptional
string · min: 1 · max: 256Optional
or
nullOptional
logo_urlany ofOptional
stringOptional
or
nullOptional
owner_idany ofOptional

The UUID of the organization owner. If not set, the current user is set as the owner.

string · uuidOptional
or
nullOptional
Responses
200
Successful Response
application/json
post
POST /organizations HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "logo_url": "text",
  "owner_id": "123e4567-e89b-12d3-a456-426614174000"
}
{
  "name": "text",
  "description": "text",
  "logo_url": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2025-07-19T14:26:05.721Z",
  "updated": "2025-07-19T14:26:05.721Z",
  "owner": {
    "password": "text",
    "password_expired": true,
    "name": "text",
    "avatar_url": "text",
    "company": "text",
    "job_title": "text",
    "metadata": {},
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "email": "text",
    "oauth_provider": "text",
    "oauth_id": "text",
    "is_active": true,
    "is_superuser": false,
    "is_service_account": false,
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "is_onboarded": false
  },
  "has_active_subscription": true,
  "trial_expiry": 1
}

Get Organization Endpoint

get

Endpoint to get an organization.

Args: organization_id_or_name: ID or name of the organization to get. include_subscription_status: Whether to include the subscription status of the org auth_context: The authentication context. rbac: RBAC component. organization_manager: Organization manager

Returns: Model of the organization.

Authorizations
Path parameters
organization_id_or_nameany ofRequired
string · uuidOptional
or
stringOptional
Query parameters
include_subscription_statusbooleanOptionalDefault: false
Responses
200
Successful Response
application/json
get
GET /organizations/{organization_id_or_name} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "name": "text",
  "description": "text",
  "logo_url": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2025-07-19T14:26:05.721Z",
  "updated": "2025-07-19T14:26:05.721Z",
  "owner": {
    "password": "text",
    "password_expired": true,
    "name": "text",
    "avatar_url": "text",
    "company": "text",
    "job_title": "text",
    "metadata": {},
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "email": "text",
    "oauth_provider": "text",
    "oauth_id": "text",
    "is_active": true,
    "is_superuser": false,
    "is_service_account": false,
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "is_onboarded": false
  },
  "has_active_subscription": true,
  "trial_expiry": 1
}

Delete Organization Endpoint

delete

Endpoint to delete an organization.

Args: organization_id: ID of the organization to delete. user: The authenticated user. organization_manager: Organization manager

Raises: IllegalOperationError: If the user does not have permissions to delete the organization.

Authorizations
Path parameters
organization_idstring · uuidRequired
Responses
200
Successful Response
application/json
Responseany
delete
DELETE /organizations/{organization_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Update Organization Endpoint

patch

Endpoint to update an organization.

Args: organization_id: ID of the organization to update. update: The organization update. user: The authenticated user. rbac: RBAC component. organization_manager: Organization manager

Returns: Model of the updated organization.

Raises: IllegalOperationError: If the user does not have permissions to update the organization.

Authorizations
Path parameters
organization_idstring · uuidRequired
Body

Model for updating organizations.

nameany ofOptional
string · min: 1 · max: 50Optional
or
nullOptional
descriptionany ofOptional
string · min: 1 · max: 256Optional
or
nullOptional
logo_urlany ofOptional
stringOptional
or
nullOptional
owner_idany ofOptional
string · uuidOptional
or
nullOptional
Responses
200
Successful Response
application/json
patch
PATCH /organizations/{organization_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 104

{
  "name": "text",
  "description": "text",
  "logo_url": "text",
  "owner_id": "123e4567-e89b-12d3-a456-426614174000"
}
{
  "name": "text",
  "description": "text",
  "logo_url": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2025-07-19T14:26:05.721Z",
  "updated": "2025-07-19T14:26:05.721Z",
  "owner": {
    "password": "text",
    "password_expired": true,
    "name": "text",
    "avatar_url": "text",
    "company": "text",
    "job_title": "text",
    "metadata": {},
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "email": "text",
    "oauth_provider": "text",
    "oauth_id": "text",
    "is_active": true,
    "is_superuser": false,
    "is_service_account": false,
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "is_onboarded": false
  },
  "has_active_subscription": true,
  "trial_expiry": 1
}
PreviousMembersNextTrial

Last updated

Was this helpful?