Create an agent

Create an agent, optionally seeded with an initial file tree. The write is atomic — validation runs before any persistence. The full file tree is omitted from the response by default; pass ?include=files to include it.

POST /v1/fleet/agents

Error

A valid request URL is required to generate request examples

201

{
  "agent_id": "<string>",
  "commit_hash": "<string>",
  "config": {
    "configurable": {
      "backend_type": "<string>",
      "llm_model_config": {},
      "sandbox_proxy_profile_ids": [
        "<string>"
      ],
      "triggers_paused": true,
      "user_email": "<string>",
      "user_name": "<string>",
      "user_timezone": "<string>"
    }
  },
  "created_at": "<string>",
  "description": "<string>",
  "files": {},
  "graph_id": "<string>",
  "metadata": {
    "agent_type": "<string>",
    "agent_version": "<string>",
    "icon": "<string>",
    "icon_color": "<string>",
    "shared_read_users": [
      "<string>"
    ],
    "shared_run_users": [
      "<string>"
    ],
    "shared_update_users": [
      "<string>"
    ],
    "tenant_access_level": "<string>",
    "visibility_scope": "<string>"
  },
  "name": "<string>",
  "owner_id": "<string>",
  "updated_at": "<string>"
}

Query Parameters

include · string

Comma-separated includes. Supported: files

Body

application/json

Agent metadata, config, and optional file tree

config · object

Show child attributes

description · string

files · object

Show child attributes

graph_id · string

metadata · object

Show child attributes

name · string

Response

201

application/json

Created

agent_id · string

commit_hash · string

config · object

Show child attributes

created_at · string

description · string

files · object

Show child attributes

graph_id · string

metadata · object

Show child attributes

name · string

owner_id · string

updated_at · string