Trillet AI logo

Update Call Agent

Update an existing agent

PUThttps://api.trillet.ai/v1/api/agents/{agentId}

Headers

x-api-keystringrequired

API key used for authenticating requests to the API.

x-workspace-idstringrequired

Workspace identifier for the API.

Path Parameters

agentIdstringrequired

The unique identifier of the agent to update.

Request Body

namestring

New name for the agent.

llmModelstringrequireddefault: gpt-4o-mini

New language model to be used by the agent to generate responses. Must be one of: gpt-4o-mini, gpt-4o-enterprise, gpt-4.1, gpt-4.1-mini, gemini-2.5-flash-preview-native-audio-dialog, gemini-2.5-flash, gemini-live-2.5-flash-preview, geminiaudiopipeline:gemini-2.5-flash-preview-native-audio-dialog, gemini-2.0-flash-live-001, gpt-5.

ttsModelobject

Text-to-Speech configuration updates.

smartCallbackbooleandefault: false

Enable smart callback functionality for the agent.

maxAttemptsForSmartCallbacknumberdefault: 5

Maximum number of callback attempts when smart callback is enabled.

gapBetweenEachAttemptForSmartCallbackarray

Array of time intervals between each callback attempt. Each item contains days and hours.

phoneNumberIdsarray

Array of phone number IDs to associate with the agent.

settingsobject

Additional settings for the agent.

variablesobject

Custom variables to store for the agent.

Response Fields

_idstring

The unique identifier of the agent.

workspaceIdstring

The workspace identifier to which the agent belongs.

userIdstring

The user identifier associated with the agent, if applicable.

namestring

The name assigned to the agent.

ttsModelobject

The configuration of the text-to-speech model used by the agent.

providerstring

The provider of the TTS service.

voiceIdstring

The specific voice ID used in the TTS model.

namestring

The name of the TTS model configuration.

languagestring

The language set for the TTS model.

elevenLabsApiKeystring

Encrypted ElevenLabs API key (only present if provider is "11labs_byo").

llmModelstring

The large language model used by the agent.

smartCallbackboolean

Whether smart callback functionality is enabled.

phoneNumberIdsarray

Array of phone number IDs associated with the agent.

activeSessionsarray

A list of active sessions associated with the agent.

roomNamestring

The name of the room for the session.

participantIdstring

The participant identifier in the session.

startTimedate

The start time of the session.

statusstring

The status of the session.

settingsobject

Any custom settings configured for the agent.

statusstring

The current status of the agent, such as "pending", "ready", or "error".

currentNodestring

The current node or state within the agent's flow or logic.

variablesobject

Custom variables stored for the agent.

createdAtstring

Timestamp when the agent was created.

updatedAtstring

Timestamp when the agent was last updated.

{
  "name": "Updated Customer Support Agent",
  "llmModel": "claude-3-5-sonnet-latest",
  "ttsModel": {
    "provider": "11labs_byo",
    "voiceId": "21m00Tcm4TlvDq8ikWAM",
    "name": "Premium Voice",
    "language": "en",
    "elevenLabsApiKey": "your-new-elevenlabs-api-key"
  },
  "smartCallback": true,
  "maxAttemptsForSmartCallback": 5,
  "gapBetweenEachAttemptForSmartCallback": [
    { "days": 1, "hours": 0 },
    { "days": 1, "hours": 12 },
    { "days": 2, "hours": 0 },
    { "days": 3, "hours": 0 },
    { "days": 7, "hours": 0 }
  ],
  "settings": {
    "speed": 0.9,
    "volume": 0.8,
    "temperature": 0.6
  }
}