curl -X POST "https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = response.json()
print(f"Build started: {data['build_id']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
console.log(`Build started: ${data.build_id}`);
{
"status": "building",
"build_id": "build_xyz789",
"message": "Template build started"
}
Builds
Build Template
Trigger a template snapshot build
POST
/
api
/
org-templates
/
{template_id}
/
build
curl -X POST "https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = response.json()
print(f"Build started: {data['build_id']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
console.log(`Build started: ${data.build_id}`);
{
"status": "building",
"build_id": "build_xyz789",
"message": "Template build started"
}
Triggers a new template build for the organization template. The build runs asynchronously. Use the Build Logs endpoint to stream progress. Requires admin or owner role.
You don’t need this after attaching or editing a skill, MCP server or guardrail: those rebuild the template by itself, from its current snapshot.
Required scope:
On a template with no repo, Build starts over from the base image and discards everything saved into the template from a session. Call this for a new template, or when you mean to reset one.
templates:build
Path Parameters
Headers
Response
Returns202 Accepted when the build is queued.
curl -X POST "https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = response.json()
print(f"Build started: {data['build_id']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/org-templates/tmpl_abc123/build",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
console.log(`Build started: ${data.build_id}`);
{
"status": "building",
"build_id": "build_xyz789",
"message": "Template build started"
}