curl "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w" \
-H "Authorization: Bearer $ATAI_API_KEY"
curl "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w?include_latest_runs=true" \
-H "Authorization: Bearer $ATAI_API_KEY"
import os
import requests
base_url = os.environ["ATAI_API_ENDPOINT"]
api_key = os.environ["ATAI_API_KEY"]
response = requests.get(
f"{base_url}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
headers={"Authorization": f"Bearer {api_key}"},
params={"include_latest_runs": "true"},
)
if response.status_code == 200:
bundle = response.json()
print(f"{bundle['name']} pins {bundle['blueprint_id']} (status {bundle['status']})")
for run in bundle.get("latest_runs") or []:
print(f" {run['id']}: {run['status']}")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_ENDPOINT}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w?include_latest_runs=true`,
{
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
const body = await response.json();
if (response.ok) {
console.log(`${body.name} pins ${body.blueprint_id} (status ${body.status})`);
(body.latest_runs ?? []).forEach(run => console.log(` ${run.id}: ${run.status}`));
} else {
console.error('Error:', body.errors);
}
{
"id": "bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
"org_id": "org_01jc8m5r2vq9xt4bn7h3kdzs6w",
"name": "Pump A monitor",
"description": "Open-set monitor tuned for pump A telemetry.",
"blueprint_id": "blp_01jc9n7k3xf8mbq2v5t0ary6de",
"models": {},
"values": {},
"artifacts": {
"calibration": "s3://.../knn_index"
},
"status": "ready",
"is_canonical": false,
"created_at": "2026-08-11T15:02:19Z",
"latest_runs": [
{
"id": "agt_01jc9q8v5nm3ry7t2bkz4dhs6f",
"status": "running",
"job_id": "job_01jc9q9k4t8v2mnr5xh7bdzy3s",
"created_at": "2026-08-11T15:10:00Z",
"started_at": "2026-08-11T15:10:04Z",
"completed_at": null,
"error": null
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Bundles
Get Bundle
Retrieve a single bundle, optionally with its recent runs
GET
/
agents
/
bundles
/
{bundle_id}
curl "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w" \
-H "Authorization: Bearer $ATAI_API_KEY"
curl "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w?include_latest_runs=true" \
-H "Authorization: Bearer $ATAI_API_KEY"
import os
import requests
base_url = os.environ["ATAI_API_ENDPOINT"]
api_key = os.environ["ATAI_API_KEY"]
response = requests.get(
f"{base_url}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
headers={"Authorization": f"Bearer {api_key}"},
params={"include_latest_runs": "true"},
)
if response.status_code == 200:
bundle = response.json()
print(f"{bundle['name']} pins {bundle['blueprint_id']} (status {bundle['status']})")
for run in bundle.get("latest_runs") or []:
print(f" {run['id']}: {run['status']}")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_ENDPOINT}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w?include_latest_runs=true`,
{
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
const body = await response.json();
if (response.ok) {
console.log(`${body.name} pins ${body.blueprint_id} (status ${body.status})`);
(body.latest_runs ?? []).forEach(run => console.log(` ${run.id}: ${run.status}`));
} else {
console.error('Error:', body.errors);
}
{
"id": "bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
"org_id": "org_01jc8m5r2vq9xt4bn7h3kdzs6w",
"name": "Pump A monitor",
"description": "Open-set monitor tuned for pump A telemetry.",
"blueprint_id": "blp_01jc9n7k3xf8mbq2v5t0ary6de",
"models": {},
"values": {},
"artifacts": {
"calibration": "s3://.../knn_index"
},
"status": "ready",
"is_canonical": false,
"created_at": "2026-08-11T15:02:19Z",
"latest_runs": [
{
"id": "agt_01jc9q8v5nm3ry7t2bkz4dhs6f",
"status": "running",
"job_id": "job_01jc9q9k4t8v2mnr5xh7bdzy3s",
"created_at": "2026-08-11T15:10:00Z",
"started_at": "2026-08-11T15:10:04Z",
"completed_at": null,
"error": null
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Requires version 1.1.9 or later of the Archetype platform.
Starting with version 2.0.1, this endpoint is removed from the platform. Use Get Package instead. To move existing code, see Migrating from Bundles and Instances.
Overview
This endpoint returns one bundle by itsbnd_ id.
Set include_latest_runs=true to attach the bundle’s most recent runs, so a bundle detail view can show run history without a second call to /agents/instances.
Request
Include the bundle’s most recent runs as
latest_runs. Off by default — it costs an extra join per bundle.Response
The pinned blueprint’s immutable
blp_ id. Resolve its key via the blueprint registry when needed.Per-slot model overrides: slot name to registry tag. If this object is empty, the bundle uses
the blueprint’s default for every slot.
The bundle’s five most recent runs, newest first. Present only when the read asked for it via
include_latest_runs=true; an empty array means the bundle has never been run. Runs are scoped to the caller’s org, so a canonical bundle shows only the caller’s own runs of it.Run summary object (latest_runs[])
External executor’s job id for this run (a JOS
job_ id). Present once the run has been dispatched.curl "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w" \
-H "Authorization: Bearer $ATAI_API_KEY"
curl "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w?include_latest_runs=true" \
-H "Authorization: Bearer $ATAI_API_KEY"
import os
import requests
base_url = os.environ["ATAI_API_ENDPOINT"]
api_key = os.environ["ATAI_API_KEY"]
response = requests.get(
f"{base_url}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
headers={"Authorization": f"Bearer {api_key}"},
params={"include_latest_runs": "true"},
)
if response.status_code == 200:
bundle = response.json()
print(f"{bundle['name']} pins {bundle['blueprint_id']} (status {bundle['status']})")
for run in bundle.get("latest_runs") or []:
print(f" {run['id']}: {run['status']}")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_ENDPOINT}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w?include_latest_runs=true`,
{
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
const body = await response.json();
if (response.ok) {
console.log(`${body.name} pins ${body.blueprint_id} (status ${body.status})`);
(body.latest_runs ?? []).forEach(run => console.log(` ${run.id}: ${run.status}`));
} else {
console.error('Error:', body.errors);
}
{
"id": "bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
"org_id": "org_01jc8m5r2vq9xt4bn7h3kdzs6w",
"name": "Pump A monitor",
"description": "Open-set monitor tuned for pump A telemetry.",
"blueprint_id": "blp_01jc9n7k3xf8mbq2v5t0ary6de",
"models": {},
"values": {},
"artifacts": {
"calibration": "s3://.../knn_index"
},
"status": "ready",
"is_canonical": false,
"created_at": "2026-08-11T15:02:19Z",
"latest_runs": [
{
"id": "agt_01jc9q8v5nm3ry7t2bkz4dhs6f",
"status": "running",
"job_id": "job_01jc9q9k4t8v2mnr5xh7bdzy3s",
"created_at": "2026-08-11T15:10:00Z",
"started_at": "2026-08-11T15:10:04Z",
"completed_at": null,
"error": null
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Important Notes
- Without
include_latest_runs=true,latest_runsis absent — an empty array means the bundle has never been run. - A run’s name is always its bundle’s name, so it is not repeated in
latest_runs. Fetch the full run (connectors, blueprint reference) fromGET /agents/instances/{agent_id}.
Was this page helpful?