latestOpenAPI 3.0.32026-08-10152216352.3 KB

eea119b4113f

Projects

Create a project

Creates a new project

post/runners/projects

Request body

namestring required

Name of the project

descriptionstring

Description of the project

labelsstring[]

Labels to assign to the project

poolIdstring uuid

UUID of the runner pool associated with the project

cronExecutionPatternstring

Cron pattern for scheduled executions

oidcAuthenticationboolean nullable

OIDC authentication setting.

parentIdstring

ID of the parent project. If missing or empty, the server will attempt to create a root project.

Example request

{
  "poolId": "123e4567-e89b-12d3-a456-426614174000"
}

Response

Project created successfully

namestring

Name of the project

descriptionstring

Description of the project

labelsstring[]

Labels to assign to the project

poolIdstring uuid

UUID of the runner pool associated with the project

cronExecutionPatternstring

Cron pattern for scheduled executions

oidcAuthenticationboolean nullable

OIDC authentication setting.

idstring

Unique identifier for the project

accountIdstring

ID of the account the project belongs to

membersCountinteger

Number of members assigned to the project

workspaceCountinteger

Number of workspaces in the project

parentIdstring

ID of the parent project (for nested projects)

Example response

{
  "poolId": "123e4567-e89b-12d3-a456-426614174000"
}