API8 min

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

MethodPathPurpose
GET/v1/environmentsSandboxes & production targets
POST/v1/sessionsOpen a promotion session
POST/v1/sessions/:id/approveRecord an approval
POST/v1/sessions/:id/promoteExecute 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.