curl -X GET "https://app.runtm.com/api/v0/deployments/dep_abc123xyz" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments/dep_abc123xyz",
headers={"Authorization": "Bearer runtm_xxx"}
)
data = response.json()
print(f"Status: {data['state']}")
if data["url"]:
print(f"URL: {data['url']}")
const response = await fetch(
"https://app.runtm.com/api/v0/deployments/dep_abc123xyz",
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
console.log(`Status: ${data.state}`);
if (data.url) {
console.log(`URL: ${data.url}`);
}
{
"deployment_id": "dep_abc123xyz",
"name": "my-api",
"state": "ready",
"url": "https://my-api-abc123.fly.dev",
"error_message": null,
"template": "backend-service",
"runtime": "python",
"version": 3,
"is_latest": true,
"previous_deployment_id": "dep_xyz789abc",
"app_name": "my-api-abc123",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:32:45Z",
"ready_at": "2024-01-15T10:32:45Z"
}
{
"detail": {
"error": "Deployment not found",
"deployment_id": "dep_invalid"
}
}
Deployments
Get Deployment
Get deployment status and details
GET
/
v0
/
deployments
/
{deployment_id}
curl -X GET "https://app.runtm.com/api/v0/deployments/dep_abc123xyz" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments/dep_abc123xyz",
headers={"Authorization": "Bearer runtm_xxx"}
)
data = response.json()
print(f"Status: {data['state']}")
if data["url"]:
print(f"URL: {data['url']}")
const response = await fetch(
"https://app.runtm.com/api/v0/deployments/dep_abc123xyz",
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
console.log(`Status: ${data.state}`);
if (data.url) {
console.log(`URL: ${data.url}`);
}
{
"deployment_id": "dep_abc123xyz",
"name": "my-api",
"state": "ready",
"url": "https://my-api-abc123.fly.dev",
"error_message": null,
"template": "backend-service",
"runtime": "python",
"version": 3,
"is_latest": true,
"previous_deployment_id": "dep_xyz789abc",
"app_name": "my-api-abc123",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:32:45Z",
"ready_at": "2024-01-15T10:32:45Z"
}
{
"detail": {
"error": "Deployment not found",
"deployment_id": "dep_invalid"
}
}
Retrieve the current status and details of a specific deployment.
Path Parameters
string
required
The deployment ID (e.g.,
dep_abc123xyz)Response
string
Unique deployment identifier
string
Project name from manifest
string
Current state:
queued, building, deploying, ready, failed, destroyedstring
Live URL (only when
ready)string
Error details (only when
failed)string
Template type
string
Runtime:
python, nodeinteger
Deployment version number
boolean
Whether this is the latest version
string
Fly.io app name (for domain commands)
string
ISO 8601 timestamp
string
When deployment became ready
curl -X GET "https://app.runtm.com/api/v0/deployments/dep_abc123xyz" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments/dep_abc123xyz",
headers={"Authorization": "Bearer runtm_xxx"}
)
data = response.json()
print(f"Status: {data['state']}")
if data["url"]:
print(f"URL: {data['url']}")
const response = await fetch(
"https://app.runtm.com/api/v0/deployments/dep_abc123xyz",
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
console.log(`Status: ${data.state}`);
if (data.url) {
console.log(`URL: ${data.url}`);
}
{
"deployment_id": "dep_abc123xyz",
"name": "my-api",
"state": "ready",
"url": "https://my-api-abc123.fly.dev",
"error_message": null,
"template": "backend-service",
"runtime": "python",
"version": 3,
"is_latest": true,
"previous_deployment_id": "dep_xyz789abc",
"app_name": "my-api-abc123",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:32:45Z",
"ready_at": "2024-01-15T10:32:45Z"
}
{
"detail": {
"error": "Deployment not found",
"deployment_id": "dep_invalid"
}
}