Coolify Octri Demo
POST/projects

Create a project

Creates a project for the authenticated user. Supply name and description to provide the project's identifying details. The 201 response includes the new project's UUID.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields

Project details to create.

descriptionstringoptional
The description of the project.
namestringoptional
The name of the project.

5 status codes
201Returns an object containing the UUID of the created project.
uuidstringoptional
The UUID of the project.
400Returned when the token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
404Returned when a referenced resource is not found.
messagestringoptional
422Returned when project data fails validation; the response includes a message and field-level errors.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned for an invalid token; a 401 when authentication is missing; a 404 when a referenced resource is not found; and a 422 when project data fails validation. Review the validation details for the submitted name and description.