curl -X DELETE "$ATAI_API_URL/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de" \
-H "Authorization: Bearer $ATAI_API_KEY"
import os
import requests
base_url = os.environ["ATAI_API_URL"]
api_key = os.environ["ATAI_API_KEY"]
response = requests.delete(
f"{base_url}/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de",
headers={"Authorization": f"Bearer {api_key}"},
)
if response.status_code == 204:
print("Blueprint deleted")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_URL}/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de`,
{
method: 'DELETE',
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
if (response.status === 204) {
console.log('Blueprint deleted');
} else {
const body = await response.json();
console.error('Error:', body.errors);
}
{
"errors": [
{
"code": "<error_code>",
"message": "Invalid reference.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Admin role required (super-admin required for canonical blueprints).",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Blueprint not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Blueprint is still referenced by a bundle.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Agents API
Delete Blueprint
Delete a blueprint by id or key
DELETE
/
agents
/
blueprints
/
{reference}
curl -X DELETE "$ATAI_API_URL/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de" \
-H "Authorization: Bearer $ATAI_API_KEY"
import os
import requests
base_url = os.environ["ATAI_API_URL"]
api_key = os.environ["ATAI_API_KEY"]
response = requests.delete(
f"{base_url}/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de",
headers={"Authorization": f"Bearer {api_key}"},
)
if response.status_code == 204:
print("Blueprint deleted")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_URL}/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de`,
{
method: 'DELETE',
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
if (response.status === 204) {
console.log('Blueprint deleted');
} else {
const body = await response.json();
console.error('Error:', body.errors);
}
{
"errors": [
{
"code": "<error_code>",
"message": "Invalid reference.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Admin role required (super-admin required for canonical blueprints).",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Blueprint not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Blueprint is still referenced by a bundle.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Requires version 1.1.9 or later of the Archetype platform.
Overview
This endpoint deletes a blueprint, addressed either by itsblp_ id or by its key.
A blueprint that is still pinned by a bundle cannot be deleted — delete the referencing bundles first.
Request
string
required
Blueprint
blp_ id or key (e.g. osm).Response
Returns204 No Content with an empty body on success.
curl -X DELETE "$ATAI_API_URL/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de" \
-H "Authorization: Bearer $ATAI_API_KEY"
import os
import requests
base_url = os.environ["ATAI_API_URL"]
api_key = os.environ["ATAI_API_KEY"]
response = requests.delete(
f"{base_url}/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de",
headers={"Authorization": f"Bearer {api_key}"},
)
if response.status_code == 204:
print("Blueprint deleted")
else:
print(f"Error: {response.json()['errors']}")
const response = await fetch(
`${process.env.ATAI_API_URL}/agents/blueprints/blp_01jc9n7k3xf8mbq2v5t0ary6de`,
{
method: 'DELETE',
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
}
);
if (response.status === 204) {
console.log('Blueprint deleted');
} else {
const body = await response.json();
console.error('Error:', body.errors);
}
{
"errors": [
{
"code": "<error_code>",
"message": "Invalid reference.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Admin role required (super-admin required for canonical blueprints).",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Blueprint not found.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
{
"errors": [
{
"code": "<error_code>",
"message": "Blueprint is still referenced by a bundle.",
"suggestion": null,
"error_uid": "err-xxxxxxxx"
}
]
}
Important Notes
- Deleting a blueprint requires the admin role; deleting a canonical blueprint requires super-admin.
- A
409means at least one bundle still pins this blueprint. Delete those bundles first. - Success returns
204with no body — check the status code rather than parsing a response.
Was this page helpful?
⌘I