POST
/
v1
/
api
/
agents
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"  
}