Stacks
Create, configure and deploy stacks inside a project.
List project stacks
Retrieve all stacks for a project.
path Parameters
projectIdProject unique identifier
List project stacks › Responses
List of stacks
idnameorganization_idproject_iddocker_composefqdnstatussynccreated_atupdated_atcreated_byCreate a stack
Create a new stack inside a project. The stack is created empty:
push a docker compose onto it with PUT /projects/{projectId}/stacks/{stackId}, then deploy it.
path Parameters
projectIdProject unique identifier
Create a stack › Responses
Stack successfully created
idnameorganization_idproject_idstack_idInfrastructure stack ID
docker_composefqdnstatussynccreated_atupdated_atcreated_bydeleted_atUpdate a stack
Update a stack's name or docker compose configuration. Setting the docker compose does not deploy it: call the deploy endpoint afterwards.
path Parameters
projectIdProject unique identifier
stackIdStack unique identifier
Update a stack › Responses
Stack successfully updated
idnameorganization_idproject_idstack_idInfrastructure stack ID
docker_composefqdnstatussynccreated_atupdated_atcreated_bydeleted_atDeploy a stack
Kicks off an asynchronous deploy. Synchronous pre-flight validation
(billing, registry image access, compose presence, deploy lock) runs
first; on success the endpoint returns 202 Accepted immediately and
the deploy proceeds in the background. Poll GET /projects/{projectId}/stacks until the stack leaves the deploying
status to observe the final result.
path Parameters
projectIdProject unique identifier
stackIdStack unique identifier
Deploy a stack › Responses
Deploy accepted and started in the background
activity_idID of the stack activity tracking this deploy
status