curl "https://app.runtm.com/api/cloud/v0/deployments?state=ready" \
-H "Authorization: Bearer runtm_xxx"
runtm-api deployments list --state ready
{
"deployments": [
{
"deployment_id": "dep_3f2a",
"name": "landing-page",
"state": "ready",
"url": "https://landing-page.runtm.app",
"error_message": null,
"version": 3,
"is_latest": true,
"previous_deployment_id": "dep_1c9b",
"app_name": "landing-page",
"template": "static-site",
"runtime": "static",
"src_hash": "5d41402a",
"created_at": "2026-07-27T20:00:00Z",
"updated_at": "2026-07-27T20:03:00Z",
"ready_at": "2026-07-27T20:03:00Z",
"discovery": null
}
],
"total": 1
}
Deployments
List Deployments
List the deployments created from sessions
GET
/
api
/
v0
/
deployments
curl "https://app.runtm.com/api/cloud/v0/deployments?state=ready" \
-H "Authorization: Bearer runtm_xxx"
runtm-api deployments list --state ready
{
"deployments": [
{
"deployment_id": "dep_3f2a",
"name": "landing-page",
"state": "ready",
"url": "https://landing-page.runtm.app",
"error_message": null,
"version": 3,
"is_latest": true,
"previous_deployment_id": "dep_1c9b",
"app_name": "landing-page",
"template": "static-site",
"runtime": "static",
"src_hash": "5d41402a",
"created_at": "2026-07-27T20:00:00Z",
"updated_at": "2026-07-27T20:03:00Z",
"ready_at": "2026-07-27T20:03:00Z",
"discovery": null
}
],
"total": 1
}
Lists deployments, newest first. These are the deployments
session deploy run produces; each carries its live URL, state, and version chain.
Required scope: deployments:read (API key auth)
Query Parameters
string
Filter by state:
queued, building, deploying, ready, failed, destroyed.integer
default:"50"
Results per page (1 to 100).
integer
default:"0"
Pagination offset.
Response
array
Deployment objects:
{deployment_id, name, state, url, error_message, version, is_latest, previous_deployment_id, app_name, template, runtime, src_hash, created_at, updated_at, ready_at, discovery}.integer
Total matches before paging.
curl "https://app.runtm.com/api/cloud/v0/deployments?state=ready" \
-H "Authorization: Bearer runtm_xxx"
runtm-api deployments list --state ready
{
"deployments": [
{
"deployment_id": "dep_3f2a",
"name": "landing-page",
"state": "ready",
"url": "https://landing-page.runtm.app",
"error_message": null,
"version": 3,
"is_latest": true,
"previous_deployment_id": "dep_1c9b",
"app_name": "landing-page",
"template": "static-site",
"runtime": "static",
"src_hash": "5d41402a",
"created_at": "2026-07-27T20:00:00Z",
"updated_at": "2026-07-27T20:03:00Z",
"ready_at": "2026-07-27T20:03:00Z",
"discovery": null
}
],
"total": 1
}