Skip to main content
POST
/
v1
/
agents
Create a new Equos Agent.
curl --request POST \
  --url https://api.equos.ai/v1/agents \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "provider": "openai",
  "name": "<string>",
  "client": {},
  "model": "gemini-2.5-flash-native-audio-preview-09-2025",
  "voice": "Puck",
  "instructions": "<string>",
  "greetingMsg": "<string>",
  "remoteId": "<string>",
  "search": true,
  "emotions": true,
  "memory": true
}
'
{
  "id": "<string>",
  "organizationId": "<string>",
  "provider": "openai",
  "search": true,
  "emotions": true,
  "memory": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "client": "<string>",
  "model": "gemini-2.5-flash-native-audio-preview-09-2025",
  "voice": "Puck",
  "instructions": "<string>",
  "greetingMsg": "<string>",
  "remoteId": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
provider
enum<string>
required
Available options:
openai,
gemini,
elevenlabs
​
name
string
Maximum string length: 64
​
client
object
​
model
enum<string>
Available options:
gemini-2.5-flash-native-audio-preview-09-2025
​
voice
enum<string>
Available options:
Puck,
Charon,
Kore,
Fenrir,
Aoede,
Leda,
Orus,
Zephyr,
Sulafat,
Sadachbia,
Sadaltager,
Vindemiatrix,
Zubenelgenubi,
Achird,
Pulcherrima,
Gacrux,
Schedar,
Alnilam,
Achernar,
Laomedeia,
Rasalgethi,
Algenib,
Erinome,
Despina,
Algieba,
Umbriel,
Iapetus,
Enceladus,
Autonoe,
Callirrhoe
​
instructions
string
​
greetingMsg
string
​
remoteId
string
​
search
boolean
​
emotions
boolean
​
memory
boolean

Response

201 - application/json
​
id
string
required
​
organizationId
string
required
​
provider
enum<string>
required
Available options:
openai,
gemini,
elevenlabs
​
search
boolean
required
​
emotions
boolean
required
​
memory
boolean
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
name
string
​
client
string
​
model
enum<string>
Available options:
gemini-2.5-flash-native-audio-preview-09-2025,
gpt-4o-realtime-preview,
gpt-realtime
​
voice
enum<string>
Available options:
Puck,
Charon,
Kore,
Fenrir,
Aoede,
Leda,
Orus,
Zephyr,
Sulafat,
Sadachbia,
Sadaltager,
Vindemiatrix,
Zubenelgenubi,
Achird,
Pulcherrima,
Gacrux,
Schedar,
Alnilam,
Achernar,
Laomedeia,
Rasalgethi,
Algenib,
Erinome,
Despina,
Algieba,
Umbriel,
Iapetus,
Enceladus,
Autonoe,
Callirrhoe,
alloy,
marin,
cedar,
ash,
ballad,
coral,
echo,
sage,
shimmer,
verse
​
instructions
string
​
greetingMsg
string
​
remoteId
string