Create a project

curl --request POST \
  --url https://auth.cognite.com/api/v1/orgs/{org}/projects \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "name": "publicdata",
      "clusterName": "westeurope-1",
      "projectAdminGroupId": "my-external-group"
    }
  ]
}
'

{
  "items": [
    {
      "projectAdminGroupId": "my-external-group",
      "name": "publicdata",
      "clusterName": "westeurope-1"
    }
  ]
}

Create a project

Create a project in the specified organization, in the given cluster. The project is immediately available for login in Cognite applications, for example through Cognite Data Fusion.

Cluster placement

The chosen cluster must be one of the allowed clusters for the organization.

The project cannot be moved to a different cluster after creation, so make sure to choose the correct one with respect to data locality requirements.

Project OIDC configuration

The OIDC configuration will be copied from the immediate parent organization.

The caller can, and should, set an initial admin group ID for the project. That group is managed by the external identity provider, as for the organization. If that group is not set, the project will inherit the admin group ID of the organization it’s created in. See the projectAdminGroupId field in the request body for more details on this behavior.

Access control

Requires the caller to be an admin in the organization, or any of its ancestors. In addition, the flag adminsCanCreateProjectsInSubtree must be set to true in that organization.

Example: Assume an organization hierarchy like: org-a -> org-b -> org-c. To create a project in org-c, which means calling ‘POST /api/v1/orgs/org-c/projects’, the caller must be an admin in org-a, org-b or org-c. Also, adminsCanCreateProjectsInSubtree must be true in that same organization.

POST

api

orgs

{org}

projects

Create a project

curl --request POST \
  --url https://auth.cognite.com/api/v1/orgs/{org}/projects \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "name": "publicdata",
      "clusterName": "westeurope-1",
      "projectAdminGroupId": "my-external-group"
    }
  ]
}
'

{
  "items": [
    {
      "projectAdminGroupId": "my-external-group",
      "name": "publicdata",
      "clusterName": "westeurope-1"
    }
  ]
}

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 a new project

items

object[]

required

Required array length: 1 element

Show child attributes

Response

A successfully created project

items

object[]

required

Required array length: 1 element

Show child attributes

Last modified on June 2, 2026

Projects

List projects in an organization

⌘I

Documentation Index

Path Parameters

Body

Response