v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Projects

Create project

Create a new project for a client. Project management must be enabled to perform this operation.

post/cloud/v1/projects

Request body

descriptionstring nullable

Description of the project.

namestring required

Unique project name for a client. Each client always has one "default" project.

Example request

{
  "description": "Project description",
  "name": "my-project"
}

Response

Created

client_idinteger required

ID associated with the client.

created_atstring date-time required

Datetime of creation, which is automatically generated.

deleted_atstring date-time nullable required

Datetime of deletion, which is automatically generated if the project is deleted.

descriptionstring nullable required

Description of the project.

idinteger required

Project ID, which is automatically generated upon creation.

is_defaultboolean required

Indicates if the project is the default one. Each client always has one default project.

namestring required

Unique project name for a client.

statestring required

The state of the project.

task_idstring nullable required

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

Example response

{
  "client_id": 1,
  "created_at": "2019-12-31T23:59:59Z",
  "description": "Project description",
  "id": 1,
  "is_default": true,
  "name": "default",
  "state": "ACTIVE",
  "task_id": "7244e161-664c-4afd-a34e-7003eac4d949"
}