Skip to Content

Organizations

12 endpoints

GET /organizations

List Orgs

List organizations the current user belongs to.

Parameters:

NameInRequiredDescription
active_onlyqueryNo
authorizationheaderNo

Response:

`any`

POST /organizations

Create Org

Create a new organization and add the current user as admin.

Parameters:

NameInRequiredDescription
authorizationheaderNo

Request body:

{ name: `string` description?: `string` | `null` }

Response:

`any`

GET /organizations/\{org_id\}

Get Org

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Response:

`any`

PUT /organizations/\{org_id\}

Update Org

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Request body:

{ name?: `string` | `null` description?: `string` | `null` active?: `boolean` | `null` }

Response:

`any`

DELETE /organizations/\{org_id\}

Delete Org

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Response:

`any`

GET /organizations/\{org_id\}/members

Get Members

List all members of an organization.

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Response:

`any`

POST /organizations/\{org_id\}/members

Add Org Member

Add a user to the organization by email.

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Request body:

{ email: `string` }

Response:

`any`

DELETE /organizations/\{org_id\}/members/\{user_id\}

Remove Org Member

Remove a user from the organization.

Parameters:

NameInRequiredDescription
org_idpathYes
user_idpathYes
authorizationheaderNo

Response:

`any`

GET /organizations/\{org_id\}/license

Get License

Get the organization’s license. No license = free plan.

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Response:

`any`

PUT /organizations/\{org_id\}/license

Assign License

Assign a license to the organization (replaces any existing one).

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Request body:

{ license_id: `string` }

Response:

`any`

DELETE /organizations/\{org_id\}/license

Unassign License

Remove the license from the organization (downgrade to free plan).

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Response:

`any`

GET /organizations/\{org_id\}/deployments

Get Org Deployments

List all deployments for the organization (via its license).

Parameters:

NameInRequiredDescription
org_idpathYes
authorizationheaderNo

Response:

`any`

Last updated on