Cloady Docs
API ReferenceEndpointsDeploys

Read the app's in-flight deploy, or its latest when none is running

Returns one `{ts, deploy}` frame: the active deploy if one is running, otherwise the most recent, and `deploy` is null when the app has never deployed. Sending `Accept: text/event-stream` instead follows it live, a frame every two seconds, closing after one terminal frame.

GET
/api/workspaces/{workspaceSlug}/apps/{appSlug}/deploys/active

Authorization

cloady
AuthorizationBearer <token>

Personal API token (cldy_…)

In: header

Path Parameters

workspaceSlug*string
appSlug*string

Query Parameters

env?string

Value in

  • "production"
  • "preview"
  • "development"
region?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/workspaces/string/apps/string/deploys/active"
{  "ts": 0,  "deploy": {    "id": "string",    "status": "building",    "commitMsg": "string",    "sha": "string",    "author": "string",    "durationMs": 0,    "createdAt": "string",    "finishedAt": "string",    "canRollback": true  }}

Roll an app back to a previous deploy's image POST

Needs a running, build-backed app whose target image is still in the registry. Restarts every service in the instance, database included.

Read a deploy's build log GET

Returns one `{kind:"snapshot", log, status}` frame — the whole log so far, not a delta: the stored log for a finished deploy, the live build pod's log for the in-flight one. Sending `Accept: text/event-stream` instead re-sends a growing snapshot every two seconds; a finished deploy sends one frame and closes, the in-flight one keeps the connection open after it ends, so close it yourself once a frame carries `final: true`.