Skip to main content
POST
/
agents
cURL
curl --request POST \
  --url https://app.zappway.ai/api/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "modelName": "gpt_5",
  "temperature": 123,
  "systemPrompt": "<string>",
  "userPrompt": "<string>",
  "promptType": "raw",
  "promptTemplate": "<string>",
  "visibility": "public"
}'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "modelName": "gpt_5",
  "temperature": 123,
  "visibility": "public",
  "systemPrompt": "<string>",
  "userPrompt": "<string>",
  "promptType": "raw",
  "promptTemplate": "<string>"
}

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_5,
gpt_5_mini,
gpt_5_nano,
gpt_4o_2024_11_20,
gpt_4o_mini_2024_07_18,
gemini_pro_2_5,
gemini_flash_2_5,
gemini_flash_2_0,
claude_4_sonnet,
claude_3_5_sonnet,
claude_3_5_haiku,
llama_4_maverick,
llama_4_scout,
sonar_pro,
deepseek_r1_0528,
deepseek_v3_0324,
grok_4,
mixtral_8x22b,
mixtral_8x7b,
dolphin_mixtral_8x7b
​
temperature
number

Temperature of the model (min 0.0, max 1.0)

​
systemPrompt
string

AI Employee System Prompt

​
userPrompt
string

AI Employee User Prompt

​
promptType
enum<string>

(DEPRECATED in favor of systemPrompt and userPrompt) Set the prompt type for this query

Available options:
raw,
customer_support
​
promptTemplate
string

(DEPRECATED in favor of systemPrompt and userPrompt) Set the prompt template for this query

​
visibility
enum<string>
Available options:
public,
private

Response

Success

​
id
string
​
name
string
​
description
string
​
modelName
enum<string>
Available options:
gpt_5,
gpt_5_mini,
gpt_5_nano,
gpt_4o_2024_11_20,
gpt_4o_mini_2024_07_18,
gemini_pro_2_5,
gemini_flash_2_5,
gemini_flash_2_0,
claude_4_sonnet,
claude_3_5_sonnet,
claude_3_5_haiku,
llama_4_maverick,
llama_4_scout,
sonar_pro,
deepseek_r1_0528,
deepseek_v3_0324,
grok_4,
mixtral_8x22b,
mixtral_8x7b,
dolphin_mixtral_8x7b
​
temperature
number

Temperature of the model (min 0.0, max 1.0)

​
visibility
enum<string>
Available options:
public,
private
​
systemPrompt
string

AI Employee System Prompt

​
userPrompt
string

AI Employee User Prompt

​
promptType
enum<string>
deprecated

(DEPRECATED in favor of systemPrompt and userPrompt) Set the prompt type for this query

Available options:
raw,
customer_support
​
promptTemplate
string
deprecated

(DEPRECATED in favor of systemPrompt and userPrompt) Set the prompt template for this query