Skip to main content
POST
Create Agent

Authorizations

Authorization
string
header
required

The access_token returned by POST /apikeys/token for an API key's secret.

Query Parameters

Body

multipart/form-data
entry
string
required
avatar
file

Response

Successful Response

title
string
required
description
string
required
knowledge_bases
string[]
required
prompt
string
required
model
string
required
id
string
required
tags
string[]
allowed_groups
string[]
allowed_user_ids
string[]
visibility
string
default:private
strict_mode
boolean
default:false
strict_mode_message
string
default:""
show_citations
boolean
default:false
core_tools
string[]
toolkits
ToolkitSelection · object[]
workflows
WorkflowSelection · object[]
agent_type
enum<string>
default:agent
Available options:
agent,
subagent
subagents
string[] | null
workflow_config
Workflow Config · object | null
skills
string[]
guardrails
Guardrails · object | null
metadata
Metadata · object | null
knowledge_base_details
KnowledgeBaseDetail · object[]
avatar
string
default:""
created_by
string | null
created_by_email
string | null
created_by_name
string | null
is_favourite
boolean
default:false
current_version_number
integer
default:0
published_revision
integer | null
next_revision
integer | null
draft
AgentDraft · object | null

The unpublished working copy of an agent.

has_draft
boolean
default:false
from_use_case
FromUseCase · object | null

The use case an agent or a workflow was activated from, and the artifact version copied.

subagent_info
SubAgentInfo · object[]
subagent_details
SubagentDetail · object[]
skill_details
SkillDetail · object[]