curl -X GET "https://app.runtm.com/api/v0/deployments?state=ready&limit=10" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments",
headers={"Authorization": "Bearer runtm_xxx"},
params={"state": "ready", "limit": 10}
)
data = response.json()
for dep in data["deployments"]:
print(f"{dep['name']}: {dep['url']}")
const response = await fetch(
"https://app.runtm.com/api/v0/deployments?state=ready&limit=10",
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
data.deployments.forEach(dep => {
console.log(`${dep.name}: ${dep.url}`);
});
{
"deployments": [
{
"deployment_id": "dep_abc123xyz",
"name": "my-api",
"state": "ready",
"url": "https://my-api-abc123.fly.dev",
"template": "backend-service",
"runtime": "python",
"version": 3,
"is_latest": true,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:32:45Z",
"ready_at": "2024-01-15T10:32:45Z"
},
{
"deployment_id": "dep_def456uvw",
"name": "landing-page",
"state": "ready",
"url": "https://landing-page-def456.fly.dev",
"template": "static-site",
"runtime": "node",
"version": 1,
"is_latest": true,
"created_at": "2024-01-14T15:20:00Z",
"updated_at": "2024-01-14T15:22:30Z",
"ready_at": "2024-01-14T15:22:30Z"
}
],
"total": 2
}
Deployments
List Deployments
Retrieve a list of all deployments
GET
/
v0
/
deployments
curl -X GET "https://app.runtm.com/api/v0/deployments?state=ready&limit=10" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments",
headers={"Authorization": "Bearer runtm_xxx"},
params={"state": "ready", "limit": 10}
)
data = response.json()
for dep in data["deployments"]:
print(f"{dep['name']}: {dep['url']}")
const response = await fetch(
"https://app.runtm.com/api/v0/deployments?state=ready&limit=10",
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
data.deployments.forEach(dep => {
console.log(`${dep.name}: ${dep.url}`);
});
{
"deployments": [
{
"deployment_id": "dep_abc123xyz",
"name": "my-api",
"state": "ready",
"url": "https://my-api-abc123.fly.dev",
"template": "backend-service",
"runtime": "python",
"version": 3,
"is_latest": true,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:32:45Z",
"ready_at": "2024-01-15T10:32:45Z"
},
{
"deployment_id": "dep_def456uvw",
"name": "landing-page",
"state": "ready",
"url": "https://landing-page-def456.fly.dev",
"template": "static-site",
"runtime": "node",
"version": 1,
"is_latest": true,
"created_at": "2024-01-14T15:20:00Z",
"updated_at": "2024-01-14T15:22:30Z",
"ready_at": "2024-01-14T15:22:30Z"
}
],
"total": 2
}
List all deployments for your account, with optional filtering and pagination.
Query Parameters
string
Filter by deployment state. One of:
queued, building, deploying, ready, failed, destroyedstring
Filter by project name (exact match)
integer
default:"50"
Maximum number of results (1-100)
integer
default:"0"
Pagination offset
Response
array
List of deployment objects
Show Deployment object
Show Deployment object
string
Unique deployment identifier (e.g.,
dep_abc123xyz)string
Project name from manifest
string
Current state:
queued, building, deploying, ready, failed, destroyedstring
Live URL (only when
ready)string
Template type:
backend-service, static-site, web-appinteger
Deployment version number
string
ISO 8601 timestamp
integer
Total count of matching deployments
curl -X GET "https://app.runtm.com/api/v0/deployments?state=ready&limit=10" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments",
headers={"Authorization": "Bearer runtm_xxx"},
params={"state": "ready", "limit": 10}
)
data = response.json()
for dep in data["deployments"]:
print(f"{dep['name']}: {dep['url']}")
const response = await fetch(
"https://app.runtm.com/api/v0/deployments?state=ready&limit=10",
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
data.deployments.forEach(dep => {
console.log(`${dep.name}: ${dep.url}`);
});
{
"deployments": [
{
"deployment_id": "dep_abc123xyz",
"name": "my-api",
"state": "ready",
"url": "https://my-api-abc123.fly.dev",
"template": "backend-service",
"runtime": "python",
"version": 3,
"is_latest": true,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:32:45Z",
"ready_at": "2024-01-15T10:32:45Z"
},
{
"deployment_id": "dep_def456uvw",
"name": "landing-page",
"state": "ready",
"url": "https://landing-page-def456.fly.dev",
"template": "static-site",
"runtime": "node",
"version": 1,
"is_latest": true,
"created_at": "2024-01-14T15:20:00Z",
"updated_at": "2024-01-14T15:22:30Z",
"ready_at": "2024-01-14T15:22:30Z"
}
],
"total": 2
}