curl "https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = response.json()
if data["allowed"]:
print("Deploy permitted")
else:
print(f"Deploy blocked: {data['reason']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy",
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
if (data.allowed) {
console.log("Deploy permitted");
} else {
console.log(`Deploy blocked: ${data.reason}`);
}
{
"allowed": true,
"reason": "Organization owner"
}
{
"allowed": false,
"reason": "Deployment disabled for member role"
}
Guardrails
Deploy Permission
Check whether the current user is allowed to deploy within an organization
GET
/
api
/
organizations
/
{org_id}
/
can-deploy
curl "https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = response.json()
if data["allowed"]:
print("Deploy permitted")
else:
print(f"Deploy blocked: {data['reason']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy",
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
if (data.allowed) {
console.log("Deploy permitted");
} else {
console.log(`Deploy blocked: ${data.reason}`);
}
{
"allowed": true,
"reason": "Organization owner"
}
{
"allowed": false,
"reason": "Deployment disabled for member role"
}
Returns whether the authenticated user has permission to deploy applications within the specified organization. Organization owners are always allowed. For other members, the result depends on the organization’s deployment limits configuration (see Org Limits).
Path Parameters
string
required
The organization ID
Headers
string
required
Bearer token.
Authorization: Bearer runtm_xxxstring
required
Must match the
org_id path parameterResponse
boolean
Whether the user is permitted to deploy
string
Human-readable explanation of the decision
curl "https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = response.json()
if data["allowed"]:
print("Deploy permitted")
else:
print(f"Deploy blocked: {data['reason']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/organizations/org_abc123/can-deploy",
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
if (data.allowed) {
console.log("Deploy permitted");
} else {
console.log(`Deploy blocked: ${data.reason}`);
}
{
"allowed": true,
"reason": "Organization owner"
}
{
"allowed": false,
"reason": "Deployment disabled for member role"
}
Scopes
| Method | Required scope |
|---|---|
| GET | deployments:read |