curl -X POST "$ATAI_API_URL/api/agents/instances" \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "pkg_01jcb2x7m4qv8n3h5t6rk9dzs0",
    "connectors": {
      "source": [
        {"type": "file", "id": "file_abc123", "format": "csv"}
      ]
    }
  }'

curl -X POST "$ATAI_API_URL/api/agents/instances" \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "pkg_01jcb2x7m4qv8n3h5t6rk9dzs0",
    "mode": "serving"
  }'

import os
import requests

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

response = requests.post(
    f"{base_url}/api/agents/instances",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "package_id": "pkg_01jcb2x7m4qv8n3h5t6rk9dzs0",
        "connectors": {
            "source": [{"type": "file", "id": "file_abc123", "format": "csv"}],
        },
    },
)

if response.status_code == 202:
    agent = response.json()
    print(f"Run accepted: {agent['id']} (status {agent['status']})")
else:
    print(f"Error: {response.json()['errors']}")

const response = await fetch(`${process.env.ATAI_API_URL}/api/agents/instances`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ATAI_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    package_id: 'pkg_01jcb2x7m4qv8n3h5t6rk9dzs0',
    connectors: {
      source: [{ type: 'file', id: 'file_abc123', format: 'csv' }]
    }
  })
});

const body = await response.json();

if (response.status === 202) {
  console.log(`Run accepted: ${body.id} (status ${body.status})`);
} else {
  console.error('Error:', body.errors);
}

{
  "id": "agt_01jcb3k8p5rw9t2bkz4dhs6fmq",
  "name": "Pump line 3",
  "org_id": "org_01jc8m5r2vq9xt4bn7h3kdzs6w",
  "package_id": "pkg_01jcb2x7m4qv8n3h5t6rk9dzs0",
  "blueprint": "osm",
  "blueprint_id": "blp_01jc9n7k3xf8mbq2v5t0ary6de",
  "mode": "batch",
  "connectors": {
    "source": [
      {"type": "file", "id": "file_abc123", "format": "csv"}
    ],
    "sink": null
  },
  "status": "running",
  "project_id": null,
  "created_at": "2026-10-21T15:20:00Z"
}

{
  "errors": [
    {
      "code": "bad_request",
      "message": "<reason>",
      "suggestion": null,
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "capability_locked",
      "message": "Blueprint not available to the caller's organization.",
      "suggestion": "Contact [email protected] to unlock it.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "not_found",
      "message": "Package 'pkg_01jcb2x7m4qv8n3h5t6rk9dzs0' not found",
      "suggestion": null,
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "conflict",
      "message": "package 'pkg_01jcb2x7m4qv8n3h5t6rk9dzs0' is not ready to run; wait until its status is `ready`",
      "suggestion": null,
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "serving_limit_reached",
      "message": "Your organization already has 5 serving agents running, the most it may run at once.",
      "suggestion": "Cancel a running serving agent, then retry.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}