Skip to main content
POST
Duplicate a agent

Authorizations

Authorization
string
header
required

OAuth2 Authorization Code flow

Path Parameters

id
string
required

Agent ID to duplicate

Query Parameters

slug
string
required

New slug for the duplicate

name
string

New name (optional, defaults to "X (copy)")

Response

Agent duplicated successfully

object
string
required

Object type

Example:

"page"

id
string
required

Unique identifier

Example:

"p_abc123"

createdAt
string<date-time>
required

Creation timestamp

Example:

"2024-01-15T10:30:00.000Z"

updatedAt
string<date-time>
required

Last update timestamp

Example:

"2024-01-15T14:45:00.000Z"

name
string
required

Agent name

Example:

"Project Management Agent"

slug
string
required

URL-friendly slug

Example:

"project-management"

status
enum<string>
required

Agent publication status

Available options:
available,
draft,
native,
internal
steps
object[]
required
evaluations
object[]
required
execution_mode
enum<string>
default:one_shot
required
Available options:
iterative,
one_shot
orgId
string
required

Organization ID

Example:

"org_123"

sync_status
enum<string>
required

Managed sync status

Available options:
pending,
preparing,
ready,
error
web_access
object
required
tool_configs
object[]
required

Built-in tool permissions

mcp_servers
object[]
required

MCP servers wired to this agent

createdBy
Created by · object

Principal who created this object

Example:
updatedBy
Updated by · object

Principal who last updated this object

Example:
description
string | null

Agent description

Example:

"Manage projects with Kanban boards"

icon
object | null

Agent icon

target_type
string | null

Target entity type

Example:

"company"

format
enum<string> | null

Agent format

Available options:
markdown,
pptx,
docx
source_file_id
string | null

Source file upload ID (for pptx/docx agents)

pptx_metadata
object | null

PPTX presentation metadata (for pptx agents)

has_steps
boolean
default:false

Whether the agent has configured steps

versions
object[]

Version history for PPTX agent analyses

current_version
string | null

Currently active version (ISO timestamp)

datasets
string[]

Distinct dataset slugs used across all steps of this agent

Example:
sync_at
string | null

Last successful managed sync timestamp

sync_error
string | null

Last managed sync error

skills_mode
enum<string>

auto grants every skill visible to the org; custom uses skill_ids; disabled grants none

Available options:
auto,
custom,
disabled
skill_ids
string[]

Skill IDs enabled for this agent

instructions
string | null
tools_mode
enum<string>

auto grants every published custom tool of the org; custom uses custom_tool_ids; disabled grants none

Available options:
auto,
custom,
disabled
custom_tool_ids
string[]

Custom tool IDs enabled for this agent

subagent_ids
string[]

Subagent IDs this agent coordinates as a multiagent

knowledge_file_ids
string[]

File upload IDs that make up this agent knowledge base