Sign in
Organizations

Create an organization

Creates a new organization. The authenticated user becomes the organization owner.

post/v1beta/organizations

Request body

namestring required

Human-readable organization name.

owner_user_idstring nullable

Owner user ID. If not provided, the authenticated user becomes the owner. Authorization: Specifying a different user requires system maintainer role. Required when the caller is a service account (service accounts cannot own organizations). Pattern: user_[0-9a-hjkmnp-tv-z]{26}

Response

Success

Example response

{
  "organization": {
    "id": "org_01h2xcejqtf2nbrexx3vqjhp41",
    "name": "Acme Corporation"
  }
}

Changes

Changed in 2 of the 50 revisions of this API.11

  • 885f41a576391See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • cb42a69ce4651See the full diff
    • ▲

      the request property became not nullable

      request-property-became-not-nullable