Composerun public API
string · uuidstringstring · uuidstring | nullstring | nullstring | nullstring · date-timestring · date-timestring · uuidintegerstring · enum
string · requiredstring · enum · requiredinteger · min: 1 · max: 10000 · requiredstring · maxLength: 500string · uuidstringstring · uuidstring | nullstring | nullintegerstring | nullstring · date-timestring · date-timestring · uuidstring | null · date-timestring | null · date-time
Projects
Create and list projects. A project owns a VM; stacks live inside it.
List organization projects
GET
https://app.composerun.eu/api/v1
/projects
Bearer
Retrieve all projects for the authenticated organization.
List organization projects › Responses
List of projects
idnameorganization_idsizedescriptionvps_idcreated_atupdated_atcreated_bystack_countNumber of non-deleted stacks attached to the project.
statusLive VM state resolved at request time. Degrades to stopped
when no VPS is provisioned and to error on infra timeouts.
Enum values:
running
stopped
deploying
error
Create a project
POST
https://app.composerun.eu/api/v1
/projects
Bearer
Create a new project in the authenticated organization. The VM is provisioned synchronously: clone → wait running → resize disk → on any failure, the VM and project are rolled back.
Create a project › Request Body
namesizeEnum values:
xs
s
m
l
xl
Example: s
disk_gbPersistent disk size in GB for the project's VM.
Example: 32
descriptionCreate a project › Responses
Project successfully created (VM provisioned and disk resized)
idnameorganization_idsizevps_iddisk_gbDisk size in GB applied to the VM.
descriptioncreated_atupdated_atcreated_bydeleted_atsuspended_at