Skip to main content
POST
Create user agent

Authorizations

Authorization
string
header
required

JWT authentication token

Body

application/json
agent_id
string
required

Unique agent ID (kebab-case)

name
string
required
system_context
string
required

System prompt for the agent

custom_tools
object[]
description
string
install_commands
string[]
is_dynamic
boolean
default:true
native_tools
string[]

List of native tool IDs to include

prereq_packages
string[]
require_env_vars
string[]
tags
string[]
verify_commands
string[]
when_to_use
string

When this agent should be triggered

Response

Agent created

description
string
required
has_dynamic_tools
boolean
required
has_memory
boolean
required
id
string
required

Agent ID for user access (use with /agents/user/{agent_id})

name
string
required
tools_count
integer
required
type
enum<string>
required
Available options:
user
config_hash
string
config_version
integer
created_at
string<date-time>
custom_tools
object[]
custom_tools_count
integer
fork_count
integer
has_installation_requirements
boolean
install_commands
string[]
native_tools
string[]
original_agent_id
string<uuid>
original_creator_id
string<uuid>
prereq_packages
string[]
published_at
string<date-time>
require_env_vars
string[]
system_context
string
tags
string[]
updated_at
string<date-time>
uuid
string<uuid>

Directory entry ID

verify_commands
string[]
visibility
enum<string>
Available options:
public,
private,
unlisted
when_to_use
string