List a workspace's recent deploys
The most recent deploys of every app in the workspace, newest first, each with the app it belongs to; with `latest`, only each app's newest deploy that isn't building, which is what an applications list shows as its last deploy. `canRollback` is always false here, since checking every row's images in the registry is too costly for a list this wide; an app's own list (listDeploys) reports it.
Authorization
cloady Personal API token (cldy_…)
In: header
Path Parameters
Query Parameters
How many deploys to return, at most 200
1 <= value <= 20050Only deploys in this state
Value in
- "building"
- "live"
- "deployed"
- "failed"
Only deploys of apps in this environment
Value in
- "production"
- "preview"
- "development"
Only deploys of apps in this region
Only each app's newest deploy that isn't building
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/workspaces/string/deploys"{ "deploys": [ { "id": "string", "status": "building", "commitMsg": "string", "sha": "string", "author": "string", "durationMs": 0, "createdAt": "string", "finishedAt": "string", "canRollback": true, "app": { "slug": "string", "env": "production", "region": "string", "name": "string" } } ]}Generate a picture for a site POST
Draws one picture from a prompt and keeps it as a one-file upload. Ship it with a site by putting { path, fromUpload: uploadId } in createUpload; an upload that no app uses within three hours is deleted. At most 40 an hour per account.
Get workspace billing info GET
Next Page