Skip to main content
POST
/
api
/
v1
/
orgs
/
{org}
/
orgs
Create an organization
curl --request POST \
  --url https://auth.cognite.com/api/v1/orgs/{org}/orgs \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "id": "my-org",
      "idp": {
        "issuer": "https://login.microsoftonline.com/some-tenant-id/v2.0"
      },
      "adminGroupId": "my-external-group",
      "adminsCanCreateOrgsInSubtree": false,
      "adminsCanCreateProjectsInSubtree": false,
      "allowedClusters": [
        "westeurope-1",
        "asia-northeast1-1"
      ]
    }
  ]
}
'
{
  "items": [
    {
      "id": "my-org",
      "parentId": "my-org",
      "idp": {
        "issuer": "https://login.microsoftonline.com/some-tenant-id/v2.0"
      },
      "adminsCanCreateOrgsInSubtree": false,
      "adminsCanCreateProjectsInSubtree": false,
      "allowedClusters": [
        "westeurope-1",
        "asia-northeast1-1"
      ],
      "adminGroupId": "my-external-group"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.cognite.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
org
string
required

ID of an organization The ID of an organization

Required string length: 3 - 64
Pattern: ^([a-z][a-z0-9-]{1,62}[a-z0-9])$
Example:

"my-org"

Body

application/json

A request to create an organization.

​
items
object[]
required
Required array length: 1 element

Response

A successfully created organization

​
items
object[]
required
Required array length: 1 element
Last modified on June 2, 2026