Skip to main content
PUT
/
agents
/
{id}
Update Agent
curl --request PUT \
  --url https://api.vogent.ai/api/agents/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "defaultVoiceId": "<string>",
  "defaultVersionedPromptId": "<string>",
  "callAgentExtractorId": "<string>",
  "inboundWebhookResponse": true,
  "inboundWebhookUrl": "<string>",
  "maxDurationSeconds": 10800,
  "metadata": {},
  "openingLine": {
    "lineType": "INBOUND_ONLY",
    "content": "<string>"
  },
  "voiceVolumeLevel": -100,
  "backgroundNoiseType": "noise",
  "linkedFunctionDefinitionIds": [
    "<string>"
  ],
  "linkedFunctionDefinitionInputs": [
    {
      "functionDefinitionId": "<string>",
      "lifecycleMessagesOverride": {
        "started": [
          "<string>"
        ]
      }
    }
  ],
  "transcriberParams": {
    "type": "deepgram",
    "keywords": [
      "<string>"
    ]
  },
  "idleMessageConfig": {
    "enabled": true,
    "messages": [
      "<string>"
    ],
    "idleDurationMilliseconds": 5001,
    "maxIdleMessages": 2
  },
  "utteranceDetectorConfig": {
    "sensitivity": "ULTRA_FAST"
  },
  "language": "<string>"
}'
{
  "id": "<string>",
  "name": "<string>",
  "transcriberParams": {
    "type": "deepgram",
    "keywords": [
      "<string>"
    ]
  },
  "metadata": {},
  "utteranceDetectorConfig": {
    "sensitivity": "ULTRA_FAST"
  },
  "idleMessageConfig": {
    "enabled": true,
    "messages": [
      "<string>"
    ],
    "idleDurationMilliseconds": 5001,
    "maxIdleMessages": 2
  },
  "language": "<string>",
  "maxDurationSeconds": 10800,
  "defaultVoiceId": "<string>",
  "defaultVersionedPromptId": "<string>",
  "defaultExtractorId": "<string>",
  "linkedFunctionDefinitions": [
    {
      "functionDefinitionId": "<string>",
      "lifecycleMessagesOverride": {
        "started": [
          "<string>"
        ]
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

In the form Bearer <api_key_here>. You can find your api key in your dashboard.

Path Parameters

id
string
required

ID of the agent.

Body

application/json

Updates an agent

name
string

The name of the agent.

defaultVoiceId
string

The ID of the default voice to use.

defaultVersionedPromptId
string

The default versioned prompt to use for this agent.

callAgentExtractorId
string

The ID of the extractor to use for this agent, if not specified, the default on the agent is used. Set to an empty string to disable the extractor.

inboundWebhookResponse
boolean
inboundWebhookUrl
string
maxDurationSeconds
integer
default:10800

The maximum duration of the call in seconds.

metadata
object
openingLine
object | null

Details about the Agent's opening line. If unspecified, or null no opening line will be created.

voiceVolumeLevel
integer
default:-100

A value, generally between -300 and 300, indicating the volume level to use for the voice. The default is -100.

backgroundNoiseType
enum<string>

The background audio that's used by the agent.

Available options:
noise,
office,
silence
linkedFunctionDefinitionIds
string[]

The function definitions that should be available to this agent (deprecated, use linkedFunctionDefinitionInputs instead)

linkedFunctionDefinitionInputs
object[]

The function definitions that should be available to this agent with optional lifecycle message overrides

transcriberParams
object
idleMessageConfig
object
utteranceDetectorConfig
object
language
string

Response

Successful operation

id
string
required
name
string
required
language
string
required

The language to use for the agent.

transcriberParams
object
metadata
object
utteranceDetectorConfig
object
idleMessageConfig
object

Configuration for idle messages that the agent can say when the user is silent.

maxDurationSeconds
integer
default:10800

The maximum duration of the call in seconds.

defaultVoiceId
string

The default voice ID to use for the agent.

defaultVersionedPromptId
string

The default versioned prompt ID to use for the agent.

defaultExtractorId
string | null

The default extractor ID to use for the agent.

linkedFunctionDefinitions
object[]

The function definitions that should be available to this agent.

I