Error

A valid request URL is required to generate request examples

{
  "access_level": "WRITE",
  "backend": {
    "sandbox_config": {
      "delete_after_stop_seconds": 1200,
      "idle_ttl_seconds": 600,
      "policy_ids": [
        "<string>"
      ],
      "sandbox_id": "<string>",
      "scope": "thread",
      "snapshot_id": "550e8400-e29b-41d4-a716-446655440000"
    },
    "type": "sandbox"
  },
  "created_at": "2026-01-15T09:30:00Z",
  "description": "Researches topics and drafts summaries.",
  "display": {
    "icon": "Rocket02",
    "icon_color": "blue"
  },
  "extras": {},
  "files": {},
  "id": "11111111-1111-1111-1111-111111111111",
  "instructions": "<string>",
  "is_owner": true,
  "model": {
    "id": "anthropic:claude-sonnet-4-6"
  },
  "name": "Research Assistant",
  "options": {
    "skip_memory_write_protection": true,
    "slack_oauth_provider_id": "<string>",
    "tools_url": "<string>",
    "trace_inputs_outputs": true,
    "triggers_paused": true,
    "user_timezone": "America/New_York"
  },
  "owner": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Ada Lovelace"
  },
  "owner_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0",
  "permissions": {
    "shared_users": {
      "read": [
        "<string>"
      ],
      "run": [
        "<string>"
      ],
      "update": [
        "<string>"
      ]
    }
  },
  "revision": "rev_3f9a2b1c",
  "subagents": [
    {
      "description": "Researches a topic and summarises findings.",
      "instructions": "<string>",
      "model": {
        "id": "anthropic:claude-sonnet-4-6"
      },
      "name": "researcher",
      "system_prompt": "You are a research assistant. Use the available tools to gather information.",
      "tools": {
        "interrupt_config": {},
        "tools": [
          {
            "display_name": "read_url_content",
            "mcp_server_name": "Fleet",
            "mcp_server_url": "https://tools.example.com",
            "name": "read_url_content"
          }
        ]
      }
    }
  ],
  "system_prompt": "You are a helpful research assistant.",
  "tools": {
    "interrupt_config": {},
    "tools": [
      {
        "display_name": "read_url_content",
        "mcp_server_name": "Fleet",
        "mcp_server_url": "https://tools.example.com",
        "name": "read_url_content"
      }
    ]
  },
  "updated_at": "2026-01-15T09:30:00Z"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Clone an agent

Creates a new agent that mirrors the source agent’s behaviour but is owned by the calling identity. Creation is atomic — the clone is either fully created or no state is persisted.

What is copied from the source:

description
runtime (model configuration)
backend (backend type + sandbox configuration)
system_prompt, tools, subagents, skills
user_timezone — inherited from the source agent
any leftover files outside the typed fields above (e.g. docs/README.md attached via the escape files field)

What the caller can override (sent in the request body):

name — defaults to "<source name> (Copy)"
permissions — defaults to the source’s identity with visibility=user and tenant_access_level=read. When supplied the object fully replaces the default; PATCH-style merging does not apply.

What is always reset for the clone (you cannot override these):

agent ID, agent version, owner, timestamps

What is never copied (start fresh on the clone):

extras (caller-defined metadata bag, e.g. icon customisations, template IDs)
caller-defined configurable bag entries
sharing state, tokens, triggers, and schedules

Cloning a built-in system template returns 422.

POST

fleet

agents

{agent_id}

clone

Error

A valid request URL is required to generate request examples

{
  "access_level": "WRITE",
  "backend": {
    "sandbox_config": {
      "delete_after_stop_seconds": 1200,
      "idle_ttl_seconds": 600,
      "policy_ids": [
        "<string>"
      ],
      "sandbox_id": "<string>",
      "scope": "thread",
      "snapshot_id": "550e8400-e29b-41d4-a716-446655440000"
    },
    "type": "sandbox"
  },
  "created_at": "2026-01-15T09:30:00Z",
  "description": "Researches topics and drafts summaries.",
  "display": {
    "icon": "Rocket02",
    "icon_color": "blue"
  },
  "extras": {},
  "files": {},
  "id": "11111111-1111-1111-1111-111111111111",
  "instructions": "<string>",
  "is_owner": true,
  "model": {
    "id": "anthropic:claude-sonnet-4-6"
  },
  "name": "Research Assistant",
  "options": {
    "skip_memory_write_protection": true,
    "slack_oauth_provider_id": "<string>",
    "tools_url": "<string>",
    "trace_inputs_outputs": true,
    "triggers_paused": true,
    "user_timezone": "America/New_York"
  },
  "owner": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Ada Lovelace"
  },
  "owner_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0",
  "permissions": {
    "shared_users": {
      "read": [
        "<string>"
      ],
      "run": [
        "<string>"
      ],
      "update": [
        "<string>"
      ]
    }
  },
  "revision": "rev_3f9a2b1c",
  "subagents": [
    {
      "description": "Researches a topic and summarises findings.",
      "instructions": "<string>",
      "model": {
        "id": "anthropic:claude-sonnet-4-6"
      },
      "name": "researcher",
      "system_prompt": "You are a research assistant. Use the available tools to gather information.",
      "tools": {
        "interrupt_config": {},
        "tools": [
          {
            "display_name": "read_url_content",
            "mcp_server_name": "Fleet",
            "mcp_server_url": "https://tools.example.com",
            "name": "read_url_content"
          }
        ]
      }
    }
  ],
  "system_prompt": "You are a helpful research assistant.",
  "tools": {
    "interrupt_config": {},
    "tools": [
      {
        "display_name": "read_url_content",
        "mcp_server_name": "Fleet",
        "mcp_server_url": "https://tools.example.com",
        "name": "read_url_content"
      }
    ]
  },
  "updated_at": "2026-01-15T09:30:00Z"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

Path Parameters

agent_id

string<uuid>

required

Source agent ID

Query Parameters

include

enum<string>

Comma-separated relations to hydrate: owner (resolve owner_id into an owner object) and/or files (raw file map). The legacy include_files=true boolean is a deprecated alias for include=files.

Available options:

owner,

files

Body

application/json

Optional overrides for the clone

name

string

Example:

"Researcher (Copy)"

permissions

object

Show child attributes

Response

Created

access_level

enum<string>

The caller's access level on this agent.

Available options:

READ,

RUN,

WRITE

Example:

"WRITE"

backend

object

Show child attributes

created_at

string<date-time>

Example:

"2026-01-15T09:30:00Z"

description

string

Example:

"Researches topics and drafts summaries."

display

object

Show child attributes

extras

object

Show child attributes

files

object

Raw file map. Returned only when include_files=true.

Show child attributes

string<uuid>

Example:

"11111111-1111-1111-1111-111111111111"

instructions

string

Deprecated: use system_prompt. Echoed alongside system_prompt with the same value for backwards compatibility.

is_owner

boolean

True when the caller owns this agent.

Example:

true

model

object

Show child attributes

name

string

Example:

"Research Assistant"

options

object

Show child attributes

owner

object

Show child attributes

owner_id

string<uuid>

Example:

"7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0"

permissions

object

Show child attributes

revision

string

Opaque identifier for the agent's current revision.

Example:

"rev_3f9a2b1c"

subagents

object[]

Subagents parsed from subagents/<name>/AGENTS.md + subagents/<name>/tools.json.

Show child attributes

system_prompt

string

Agent system prompt parsed from AGENTS.md.

Example:

"You are a helpful research assistant."

tools

object

Tool config parsed from tools.json.

Show child attributes

updated_at

string<date-time>

Example:

"2026-01-15T09:30:00Z"

Update an agent

Check agent MCP-server health