Skip to main content
POST
/
governance
/
organizations
Create a new organization
curl --request POST \
  --url https://api.example.com/governance/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "alias": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for creating a new organization.

​
name
string
required

Display name of the organization

Required string length: 1 - 255
​
description
string | null

Optional description of the organization

Maximum string length: 500

Response

Successful Response

Response after successfully creating an organization.

​
id
string
required

Keycloak organization UUID (tenant id for APIs, OpenFGA, and data scoping)

​
name
string
required

Display name of the organization

​
alias
string
required

Keycloak organization alias (URL-safe slug for OIDC scope=organization:)

​
created_at
string<date-time>
required

Timestamp when the organization was created

​
description
string | null

Description of the organization