v64

OpenAPI 3.1.0raw.githubusercontent.com2026-08-01176310978.7 KB

organizations

Create Organization

Create a new organization.

post/api/v1/organizations/

Response

Successful Response

display_namestring required

The human-readable display name of the organization.

descriptionstring nullable

Description of the organization.

domainsstring nullable

Comma-delimited list of domains that users at the organization may have in their email addresses.

saml_provider_idstring nullable

SAML provider ID for user authentication

idinteger required

The internal ID of the organization.

last_updated_commentsstring nullable

Comments for the most recent edit to the organization.

namestring required

Unique, non-human-readable hash for the organization

slugstring nullable

The slug of the organization used for URLs in the Console UI. Null until slug backfill has been run.

last_updatedstring date-time required

The timestamp of the most recent update to the organization

last_updated_bystring nullable

The email of the user who most recently updated the organization

logo_urlstring nullable

CDN URL. The org will always have a logo, but this value will be null on a response to an update where no logo was provided on the request

Example response

{
  "display_name": "My Great Org",
  "description": "An organization that does great things with agentic AI.",
  "domains": "mygreatorg.com,myothergreatorg.org",
  "saml_provider_id": "saml.syllablesso",
  "id": 1,
  "last_updated_comments": "Updated to add an additional domain",
  "slug": "my-great-org",
  "logo_url": "https://image.png"
}