curl -X POST "$ATAI_API_URL/agents/blueprints" \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blueprint_key": "osm",
    "document": {
      "name": "Open-set monitor",
      "description": "Classifies incoming records against a known class vocabulary.",
      "connectors": {
        "input": {"key": "<node_key>", "config": {}},
        "output": {"key": "<node_key>", "config": {}}
      },
      "nodes": {
        "classifier": {"key": "<node_key>", "config": {}}
      },
      "graph": {
        "edges": [
          {"from": "input", "to": "classifier"},
          {"from": "classifier", "to": "output"}
        ]
      },
      "values": {},
      "artifacts": {}
    }
  }'

curl -X POST "$ATAI_API_URL/agents/blueprints" \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blueprint_key": "osm",
    "replacement_of": "blp_01jc8k2m9vr4te7hn5b3qdzx8w",
    "yaml_document": "name: Open-set monitor\ngraph:\n  edges: []\n"
  }'

import os
import requests

base_url = os.environ["ATAI_API_URL"]
api_key = os.environ["ATAI_API_KEY"]

response = requests.post(
    f"{base_url}/agents/blueprints",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "blueprint_key": "osm",
        "document": {
            "name": "Open-set monitor",
            "description": "Classifies incoming records against a known class vocabulary.",
            "connectors": {
                "input": {"key": "<node_key>", "config": {}},
                "output": {"key": "<node_key>", "config": {}},
            },
            "nodes": {
                "classifier": {"key": "<node_key>", "config": {}},
            },
            "graph": {
                "edges": [
                    {"from": "input", "to": "classifier"},
                    {"from": "classifier", "to": "output"},
                ]
            },
        },
    },
)

if response.status_code == 201:
    blueprint = response.json()
    print(f"Created {blueprint['id']} under key {blueprint['blueprint_key']}")
else:
    print(f"Error: {response.json()['errors']}")

const response = await fetch(`${process.env.ATAI_API_URL}/agents/blueprints`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ATAI_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    blueprint_key: 'osm',
    document: {
      name: 'Open-set monitor',
      description: 'Classifies incoming records against a known class vocabulary.',
      connectors: {
        input: { key: '<node_key>', config: {} },
        output: { key: '<node_key>', config: {} }
      },
      nodes: {
        classifier: { key: '<node_key>', config: {} }
      },
      graph: {
        edges: [
          { from: 'input', to: 'classifier' },
          { from: 'classifier', to: 'output' }
        ]
      }
    }
  })
});

const body = await response.json();

if (response.status === 201) {
  console.log(`Created ${body.id} under key ${body.blueprint_key}`);
} else {
  console.error('Error:', body.errors);
}

{
  "id": "blp_01jc9n7k3xf8mbq2v5t0ary6de",
  "blueprint_key": "osm",
  "name": "Open-set monitor",
  "description": "Classifies incoming records against a known class vocabulary.",
  "document": {
    "blueprint_id": "blp_01jc9n7k3xf8mbq2v5t0ary6de",
    "name": "Open-set monitor",
    "description": "Classifies incoming records against a known class vocabulary.",
    "connectors": {
      "input": {"key": "<node_key>", "config": {}},
      "output": {"key": "<node_key>", "config": {}}
    },
    "nodes": {
      "classifier": {"key": "<node_key>", "config": {}}
    },
    "graph": {
      "edges": [
        {"from": "input", "to": "classifier"},
        {"from": "classifier", "to": "output"}
      ]
    },
    "values": {},
    "artifacts": {}
  },
  "yaml_document": null,
  "is_canonical": false,
  "is_active": true,
  "created_at": "2026-08-11T14:32:07Z"
}

{
  "errors": [
    {
      "code": "<error_code>",
      "message": "Invalid request, or `replacement_of` does not match the given key/scope.",
      "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": "`replacement_of` blueprint not found.",
      "suggestion": null,
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "<error_code>",
      "message": "Blueprint key already exists, or `replacement_of` is no longer the active version.",
      "suggestion": null,
      "error_uid": "err-xxxxxxxx"
    }
  ]
}