POST
/
v1
/
api
/
agents
Create Call Agent
curl --request POST \
  --url https://api.trillet.ai/v1/api/agents \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '{
  "name": "<string>",
  "ttsModel": {
    "provider": "<string>",
    "voiceId": "<string>",
    "name": "<string>",
    "language": "<string>"
  },
  "llmModel": "<string>",
  "type": "<string>",
  "settings": {
    "speed": 123,
    "volume": 123,
    "temperature": 123
  }
}'
{  
  "agentId": "mock-agent-id-1234",  
  "workspaceId": "mock-workspace-id-5678",  
  "userId": "mock-user-id-91011",  
  "ttsProvider": "cartesia",  
  "ttsVoice": "Wildflower",  
  "ttsLanguage": "en",  
  "llmModel": "gpt-4o"  
}

​
Headers

​
x-api-key
string
required
API key used for authenticating requests to the API.
​
x-workspace-id
string
required
Workspace identifier for the API.

​
Request Body

​
name
string
required
Name of the agent being created.
​
ttsModel
object
required
Text-to-Speech (TTS) configuration for the agent.
​
llmModel
string
default:"gpt-4o-mini"
required
Language Model to be used by the agent to generate responses. (e.g. gpt-4o, gpt-4o-mini, gpt-4o-enterprise)
​
type
string
default:"voice"
required
Type of agent. Should always be set to voice.
​
settings
object
required
Additional settings for the agent.

​
Response Fields

​
agentId
string
Unique identifier for the newly created agent.
​
workspaceId
string
Workspace ID associated with the agent.
​
userId
string
User ID of the agent creator.
​
ttsProvider
string
Text-to-Speech provider for the agent.
​
ttsVoice
string
Name of the voice used for TTS.
​
ttsLanguage
string
Language of the TTS voice.
​
llmModel
string
Language Model to be used by the agent to generate responses.

​
Example Request

{
  "name": "Customer Support Agent",
  "ttsModel": {
    "provider": "cartesia",
    "voiceId": "mistv2_Wildflower",
    "name": "Sophie",
    "language": "en"
  },
  "llmModel": "gpt-4o",
  "type": "voice",
  "settings": {
    "speed": 0.8,
    "volume": 1,
    "temperature": 0.7
  }
}

​
Example Response

{  
  "agentId": "mock-agent-id-1234",  
  "workspaceId": "mock-workspace-id-5678",  
  "userId": "mock-user-id-91011",  
  "ttsProvider": "cartesia",  
  "ttsVoice": "Wildflower",  
  "ttsLanguage": "en",  
  "llmModel": "gpt-4o"  
}