Create or update an app from a docker-compose.yml
POST /apps/deploy
POST
/apps/deploy
Writes the compose file under the apps directory and triggers a deploy.
Use validate-compose first to catch label or syntax errors.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
name
required
App name (becomes the slug).
string
compose
required
Full docker-compose.yml content.
string
env
Optional .env file content.
string
Responses
Section titled “ Responses ”Deploy accepted; watch progress via the deploy logs WebSocket.
object
slug
string
status
string
Example
deployingInvalid request.
string