curl "https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info",
headers={"Authorization": "Bearer runtm_xxx"},
)
data = response.json()
print(f"Ready: manifest={data['has_manifest']}, dockerfile={data['has_dockerfile']}")
print(f"Apps: {data['user_app_count']}/{data['max_apps']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info",
{
headers: {
"Authorization": "Bearer runtm_xxx",
},
}
);
const data = await response.json();
console.log(`Ready: manifest=${data.has_manifest}, dockerfile=${data.has_dockerfile}`);
console.log(`Apps: ${data.user_app_count}/${data.max_apps}`);
{
"has_manifest": true,
"has_dockerfile": true,
"detected_template": "docker",
"detected_runtime": null,
"recommended_tier": "starter",
"user_app_count": 1,
"max_apps": 5,
"allowed_tiers": ["starter", "performance"]
}
Deploy
Deploy Info
Get current deployment status and tier recommendation for a session
GET
/
api
/
sessions
/
{session_id}
/
deploy
/
info
curl "https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info",
headers={"Authorization": "Bearer runtm_xxx"},
)
data = response.json()
print(f"Ready: manifest={data['has_manifest']}, dockerfile={data['has_dockerfile']}")
print(f"Apps: {data['user_app_count']}/{data['max_apps']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info",
{
headers: {
"Authorization": "Bearer runtm_xxx",
},
}
);
const data = await response.json();
console.log(`Ready: manifest=${data.has_manifest}, dockerfile=${data.has_dockerfile}`);
console.log(`Apps: ${data.user_app_count}/${data.max_apps}`);
{
"has_manifest": true,
"has_dockerfile": true,
"detected_template": "docker",
"detected_runtime": null,
"recommended_tier": "starter",
"user_app_count": 1,
"max_apps": 5,
"allowed_tiers": ["starter", "performance"]
}
Returns deployment readiness information for a session, including whether config files exist, the detected project type, recommended tier, and the user’s current deployment count against their plan limits.
Required scope:
deployments:read
Path Parameters
string
required
The session ID (UUID).
Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Scope to an organization.
Response
boolean
Whether a
runtm.yaml manifest exists in the project.boolean
Whether a
Dockerfile exists in the project.string | null
Template type detected from the manifest (e.g.
docker, static-site).string | null
Runtime detected from the manifest.
string
Recommended machine tier (
starter, performance, pro).integer
Number of active deployments the user currently has.
integer
Maximum deployments allowed on the user’s plan.
array
List of tiers available on the user’s plan.
curl "https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info",
headers={"Authorization": "Bearer runtm_xxx"},
)
data = response.json()
print(f"Ready: manifest={data['has_manifest']}, dockerfile={data['has_dockerfile']}")
print(f"Apps: {data['user_app_count']}/{data['max_apps']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/info",
{
headers: {
"Authorization": "Bearer runtm_xxx",
},
}
);
const data = await response.json();
console.log(`Ready: manifest=${data.has_manifest}, dockerfile=${data.has_dockerfile}`);
console.log(`Apps: ${data.user_app_count}/${data.max_apps}`);
{
"has_manifest": true,
"has_dockerfile": true,
"detected_template": "docker",
"detected_runtime": null,
"recommended_tier": "starter",
"user_app_count": 1,
"max_apps": 5,
"allowed_tiers": ["starter", "performance"]
}