v2

latestOpenAPI 3.0.3Apache-2.02026-08-07119359591.9 KB

Organizations

Create an organization

Create a new organization within the account.

Payload Requirements

name is required and must be unique within the account.
description is optional and defaults to an empty string if omitted.
System-managed fields (id, created_at) are generated automatically and rejected if provided.

Valid example

{
  "name": "Agent Engineering Team",
  "description": "Organization for the Agent Engineering team"
}

Invalid example (duplicate name)

{
  "name": "Agent Engineering Team"
}

Fails with 409 Conflict if an organization with that name already exists in the account.

<Note>This endpoint is in beta, read more here.</Note>

post/v2/organizations

namestring required

Name of the organization (must be unique within the account)

descriptionstring

A brief description of the organization's purpose. Defaults to an empty string if omitted.

An organization object

idstring required

A universally unique identifier (base64-encoded opaque string).

namestring required

Name of the organization

descriptionstring required

A brief description of the organization's purpose

created_atstring date-time required

Timestamp for when the organization was created

{
  "id": "RW50aXR5OjEyMzQ1"
}