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.
Required scope:
templates:build
Path Parameters
string
required
The template ID (e.g.
tmpl_abc123).Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
required
Organization ID.
Response
Returns202 Accepted when the build is queued.
string
Build status (
building).string
Unique ID for this build.
string
Confirmation message.
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"
}