curl "https://app.runtm.com/api/cloud/deploy/limits" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/deploy/limits",
headers={"Authorization": "Bearer runtm_xxx"},
)
data = response.json()
remaining = data["max_apps"] - data["user_app_count"]
print(f"Plan: {data['plan_name']}")
print(f"Deployed: {data['user_app_count']}/{data['max_apps']}")
print(f"Remaining slots: {remaining}")
print(f"Allowed tiers: {', '.join(data['allowed_tiers'])}")
const response = await fetch(
"https://app.runtm.com/api/cloud/deploy/limits",
{
headers: {
"Authorization": "Bearer runtm_xxx",
},
}
);
const data = await response.json();
const remaining = data.max_apps - data.user_app_count;
console.log(`Plan: ${data.plan_name}`);
console.log(`Deployed: ${data.user_app_count}/${data.max_apps}`);
console.log(`Remaining slots: ${remaining}`);
{
"max_apps": 10,
"user_app_count": 3,
"allowed_tiers": ["starter", "standard", "performance"],
"plan_name": "pro"
}
{
"max_apps": 2,
"user_app_count": 2,
"allowed_tiers": ["starter"],
"plan_name": "free"
}
Guardrails
Deploy Limits
Get plan-based deployment limits for the current user
GET
/
api
/
deploy
/
limits
curl "https://app.runtm.com/api/cloud/deploy/limits" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/deploy/limits",
headers={"Authorization": "Bearer runtm_xxx"},
)
data = response.json()
remaining = data["max_apps"] - data["user_app_count"]
print(f"Plan: {data['plan_name']}")
print(f"Deployed: {data['user_app_count']}/{data['max_apps']}")
print(f"Remaining slots: {remaining}")
print(f"Allowed tiers: {', '.join(data['allowed_tiers'])}")
const response = await fetch(
"https://app.runtm.com/api/cloud/deploy/limits",
{
headers: {
"Authorization": "Bearer runtm_xxx",
},
}
);
const data = await response.json();
const remaining = data.max_apps - data.user_app_count;
console.log(`Plan: ${data.plan_name}`);
console.log(`Deployed: ${data.user_app_count}/${data.max_apps}`);
console.log(`Remaining slots: ${remaining}`);
{
"max_apps": 10,
"user_app_count": 3,
"allowed_tiers": ["starter", "standard", "performance"],
"plan_name": "pro"
}
{
"max_apps": 2,
"user_app_count": 2,
"allowed_tiers": ["starter"],
"plan_name": "free"
}
Returns the deployment limits for the authenticated user based on their billing plan. Includes the maximum number of apps allowed, current usage, permitted machine tiers, and plan name.
Headers
string
required
Bearer token.
Authorization: Bearer runtm_xxxResponse
integer
Maximum number of deployed apps allowed on the current plan
integer
Number of apps the user currently has deployed
array
Machine tiers available on the current plan (e.g.
["starter", "standard"])string
Name of the user’s current billing plan
curl "https://app.runtm.com/api/cloud/deploy/limits" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/deploy/limits",
headers={"Authorization": "Bearer runtm_xxx"},
)
data = response.json()
remaining = data["max_apps"] - data["user_app_count"]
print(f"Plan: {data['plan_name']}")
print(f"Deployed: {data['user_app_count']}/{data['max_apps']}")
print(f"Remaining slots: {remaining}")
print(f"Allowed tiers: {', '.join(data['allowed_tiers'])}")
const response = await fetch(
"https://app.runtm.com/api/cloud/deploy/limits",
{
headers: {
"Authorization": "Bearer runtm_xxx",
},
}
);
const data = await response.json();
const remaining = data.max_apps - data.user_app_count;
console.log(`Plan: ${data.plan_name}`);
console.log(`Deployed: ${data.user_app_count}/${data.max_apps}`);
console.log(`Remaining slots: ${remaining}`);
{
"max_apps": 10,
"user_app_count": 3,
"allowed_tiers": ["starter", "standard", "performance"],
"plan_name": "pro"
}
{
"max_apps": 2,
"user_app_count": 2,
"allowed_tiers": ["starter"],
"plan_name": "free"
}
Scopes
| Method | Required scope |
|---|---|
| GET | deployments:read |