Reference

HTTP API

Authentication, the promotion endpoint, and webhook payloads.

Authentication

All requests take a bearer token.

Authorization: Bearer <token>

POST /v1/promotions

{
  "service": "api-gateway",
  "from": "staging",
  "to": "production",
  "reason": "release 2411"
}

Returns 202 Accepted with a promotion id. Poll /v1/promotions/{id} or subscribe to the promotion.settled webhook.

600 requests per minute per token. The limit is returned in X-RateLimit-Remaining.