API Overview
Authenticate with bearer tokens, list environments, and open deploy sessions. Examples below mirror Desk/Enterprise promotion flows.
Authentication
Send Authorization: Bearer <token> on every request. Rotate tokens from the Enterprise console.
# List environments
curl -s https://api.deploy-engine.example/v1/environments \
-H "Authorization: Bearer $DE_TOKEN"
Core resources
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/environments | Sandboxes & production targets |
| POST | /v1/sessions | Open a promotion session |
| POST | /v1/sessions/:id/approve | Record an approval |
| POST | /v1/sessions/:id/promote | Execute the rollout |
Open a session
POST /v1/sessions
{
"environment": "prod-eu-west",
"policy": {
"volatilityMax": 0.8,
"concentrationMax": 1.2,
"spreadMax": 0.15
}
}
Audit exports
GET /v1/audit/exports returns immutable change records suitable for EU/US compliance reviews. Pair with the status page during incidents.