Skip to main content
POST
Create a new agent.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
description
string
required
name
string
modelName
enum<string>
Available options:
gpt_4o,
gpt_4o_mini,
gpt_41,
gpt_41_mini,
gpt_41_nano,
claude_3_7_sonnet,
claude_4_sonnet,
gemini_2_5_flash,
gemini_2_5_pro,
grok_3,
grok_3_beta,
grok_3_fast_beta,
grok_3_mini_beta,
grok_3_mini_fast_beta,
sonar_pro,
sonar,
llama_3_3_70b,
llama_4_maverick_17b,
model_route
temperature
number
Required range: 0 <= x <= 1
systemPrompt
string
userPrompt
string
promptType
enum<string>
deprecated
Available options:
raw,
customer_support
promptTemplate
string
deprecated
visibility
enum<string>
Available options:
public,
private
handle
string

Unique handle (4-15 chars, letters/numbers/_)

useSuperRetrieval
boolean
retrievalEvaluationConfig
object
useFollowUp
boolean
followUpConfig
object
tools
object[]

Response

Success

id
string
name
string
description
string
modelName
enum<string>
Available options:
gpt_4o,
gpt_4o_mini,
gpt_41,
gpt_41_mini,
gpt_41_nano,
claude_3_7_sonnet,
claude_4_sonnet,
gemini_2_5_flash,
gemini_2_5_pro,
grok_3,
grok_3_beta,
grok_3_fast_beta,
grok_3_mini_beta,
grok_3_mini_fast_beta,
sonar_pro,
sonar,
llama_3_3_70b,
llama_4_maverick_17b,
model_route
temperature
number
visibility
enum<string>
Available options:
public,
private
systemPrompt
string
userPrompt
string
handle
string
useSuperRetrieval
boolean
useFollowUp
boolean
promptType
enum<string>
deprecated
Available options:
raw,
customer_support
promptTemplate
string
deprecated
retrievalEvaluationConfig
object
followUpConfig
object
tools
object[]