Cloady Docs
API ReferenceEndpointsDeploys

Roll an app back to a previous deploy's image

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

POST
/api/workspaces/{workspaceSlug}/apps/{appSlug}/deploys/{deployId}/rollback

Authorization

cloady
AuthorizationBearer <token>

Personal API token (cldy_…)

In: header

Path Parameters

workspaceSlug*string
appSlug*string
deployId*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 POST "https://example.com/api/workspaces/string/apps/string/deploys/string/rollback"
{  "deploy": {    "id": "string",    "status": "building",    "commitMsg": "string",    "sha": "string",    "author": "string",    "durationMs": 0,    "createdAt": "string",    "finishedAt": "string",    "canRollback": true  }}

Redeploy an app (refresh code + roll pods) POST

Previous Page

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

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.