ToolsXpo

DevOps & Config

Docker Compose Builder API

POST request to /v1/docker-compose-builder, returning text in the standard envelope.

POST/v1/docker-compose-builder2 credits / call Free tier

Authentication

Send your API key as a bearer token. Create one free in the dashboard.

Authorization: Bearer $TOOLSXPO_KEY

Parameters

Sent as fields in the JSON body. The values below are the examples used throughout this page.

NameExample value
servicesweb,db
nginxPort80:80
pgDbapp
pgUseradmin
pgPasssecret_password
nodePort3000:3000
redisPort6379:6379

Example request

curl -X POST "https://api.toolsxpo.com/v1/docker-compose-builder" \
  -H "Authorization: Bearer $TOOLSXPO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"services":"web,db","nginxPort":"80:80","pgDb":"app","pgUser":"admin","pgPass":"secret_password","nodePort":"3000:3000","redisPort":"6379:6379"}'

Response

Every endpoint answers with the same envelope. The result is in data (text); meta.credits reports what the call cost.

{
  "ok": true,
  "data": { /* text */ },
  "meta": { "credits": 2 }
}

Errors

Failures use the same envelope with ok: false and a machine-readable code.

StatusCodeMeaning
400invalid_inputA parameter failed validation. `details` lists which.
401unauthorizedMissing or invalid API key.
402quota_exceededOut of credits on this workspace.
404not_foundNo such tool.
429rate_limitedToo many requests. Retry after `Retry-After` seconds.
503service_unavailableTemporarily disabled by an administrator.