curl -X DELETE "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w" \
-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.delete(
f"{base_url}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
headers={"Authorization": f"Bearer {api_key}"},
)
if response.status_code == 204:
print("Bundle deleted")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_ENDPOINT}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w`,
{
method: 'DELETE',
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
if (response.status === 204) {
console.log('Bundle deleted');
} else {
const body = await response.json();
console.error('Error:', body.errors);
}
{
"errors": [
{
"code": "<error_code>",
"message": "Super-admin required for canonical bundles.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle is still referenced by runs or evals.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Bundles
Delete Bundle
Delete a bundle by id
DELETE
/
agents
/
bundles
/
{bundle_id}
curl -X DELETE "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w" \
-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.delete(
f"{base_url}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
headers={"Authorization": f"Bearer {api_key}"},
)
if response.status_code == 204:
print("Bundle deleted")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_ENDPOINT}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w`,
{
method: 'DELETE',
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
if (response.status === 204) {
console.log('Bundle deleted');
} else {
const body = await response.json();
console.error('Error:', body.errors);
}
{
"errors": [
{
"code": "<error_code>",
"message": "Super-admin required for canonical bundles.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle is still referenced by runs or evals.",
"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 Delete Package instead. To move existing code, see Migrating from Bundles and Instances.
Overview
This endpoint deletes a bundle by itsbnd_ id.
A bundle that is still referenced by runs or evals returns 409 — delete those first.
Deleting the bundles that pin a blueprint is the prerequisite for deleting that blueprint, which returns 409 while any bundle still references it.
Request
Response
Returns204 No Content with an empty body on success.
curl -X DELETE "$ATAI_API_ENDPOINT/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w" \
-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.delete(
f"{base_url}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w",
headers={"Authorization": f"Bearer {api_key}"},
)
if response.status_code == 204:
print("Bundle deleted")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_ENDPOINT}/agents/bundles/bnd_01jc9pd42kzq7v8n3h5m6rtx0w`,
{
method: 'DELETE',
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
if (response.status === 204) {
console.log('Bundle deleted');
} else {
const body = await response.json();
console.error('Error:', body.errors);
}
{
"errors": [
{
"code": "<error_code>",
"message": "Super-admin required for canonical bundles.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Bundle is still referenced by runs or evals.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Important Notes
- Deleting a canonical bundle requires the super-admin role.
- A
409means at least one run or eval still references this bundle. Delete those first. v1.1.12+ - Success returns
204with no body — check the status code rather than parsing a response.
Was this page helpful?