Deployments
List deployments
Deployments across every service in the organization, newest first, a page at a time.
Updated
https://cloud.cahaves.com/api/deployments
Authorization
cahaves.cloud.sessionstringcookierequired
The session cookie Cloud sets when a customer signs in to the console with GitHub or Google. It is HttpOnly, so scripts cannot read it, and there are no API keys or tokens yet.
Query parameters
pageinteger
The page to answer, from 1. Anything but a whole number reads as absent, and a page past the last answers an empty list.
Default: 1
perinteger
Rows per page, 1 to 100. A number outside that range is clamped to it, and anything but a whole number reads as absent.
Default: 25
service_idstring<uuid>
Only this service's deployments. A service outside the organization the request works in answers 404.
statusstring
`active` for deployments still in progress, or `done`, `error` or `cancelled`, matching `display_status`. Any other value lists every deployment.
Allowed values: "active""done""error""cancelled"
Headers
X-Cloud-Organizationstring<uuid>
The id of the organization the request works in, one the signed-in customer owns. Left out or empty, the request works in their oldest organization. Any other value answers 404 with `reason: "organization"`. A customer with no organization yet gets 409 "Create an organization first." from every route that works in one.
Example: "2f6c8e0a-4b1d-4e7f-9a3c-5d7e9f1b3a5c"
Responses
application/json
A page of deployments.
perintegerrequired
pageintegerrequired
totalintegerrequired
deploymentsobject[]required
Use service_id for one service's history and status to narrow the list: active for everything still in progress, done, error for failures, or cancelled, which includes deployments stopped at your request. Any other status lists everything.