Partially update an existing voice AI agent

http
PATCH https://services.leadconnectorhq.com/voice-ai/agents/{agentId}

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Path parameters

NameTypeRequiredExampleDescription
agentIdstringYes507f1f77bcf86cd799439011Unique agent identifier

Query parameters

NameTypeRequiredExampleDescription
locationIdstringYesLOC123456789ABCDEFAccount ID

Body

NameTypeRequiredExampleDescription
agentNamestringNoCustomer Support AgentDisplay name for the voice AI agent, between 1-40 characters. Default: "My Agent {random 3 digit number}"
businessNamestringNoAcme CorporationName of the business this agent represents. Default: Uses account name
welcomeMessagestringNoHello! Thank you for calling Acme Corporation. How can I assist you today?Initial greeting spoken when the agent answers calls. Default: Auto generated
agentPromptstringNoYou are a helpful customer service representative. Always be polite and professional.Custom instructions defining the agent's behavior and personality. Default: Basic prompt generated automatically
voiceIdstringNo507f1f77bcf86cd799439011Identifier for the speech synthesis voice from available voice options. Default: Auto generated
languagestringNoLanguage code for the agent's speech and understanding. Default: "en-US" Possible values: 'en-US', 'pt-BR', 'es', 'fr', 'de', 'it', 'nl-NL', 'multi'
patienceLevelstringNoTolerance level for caller response delays. Default: "high" Possible values: 'low', 'medium', 'high'
maxCallDurationnumberNo600Maximum call duration in seconds, between 180-900 (3-15 minutes). Default: 300 seconds (5 minutes)
sendUserIdleRemindersbooleanNoTrueEnables automatic reminders when callers are silent. Default: true
reminderAfterIdleTimeSecondsnumberNo5Seconds to wait before sending idle reminders, between 1-20. Default: 8 seconds
inboundNumberstringNo+1234567890Phone number for receiving inbound calls to this agent. Default: null
numberPoolIdstringNopool_507f1f77bcf86cd799439011Identifier for the number pool managing phone number allocation. Default: null
callEndWorkflowIdsstring[]NoArray of workflow IDs to trigger automatically when calls end. Default: []
sendPostCallNotificationToobjectNoConfiguration for post-call email notifications to various recipients. Default: []
  • agentWorkingHours (object[]): Time intervals defining when the agent accepts calls, organized by day of week. Default: [] (available 24/7)

    • dayOfTheWeek (number, required): Day of the week for this working hours configuration (Monday=1 to Sunday=7) Possible values: 1, 2, 3, 4, 5, 6, 7 Example: 1

    • intervals (object[], required): Array of time intervals when the agent is available on this day

      • startHour (number, required): Starting hour of the working interval in 24-hour format (0-23) Example: 9

      • endHour (number, required): Ending hour of the working interval in 24-hour format (0-23) Example: 17

      • startMinute (number, required): Starting minute of the working interval (0-59) Example: 0

      • endMinute (number, required): Ending minute of the working interval (0-59) Example: 30

NameTypeRequiredExampleDescription
timezonestringNoAmerica/New_YorkIANA timezone identifier affecting working hours and scheduling. Default: Account timezone
isAgentAsBackupDisabledbooleanNoFalsePrevents this agent from being used as a fallback option. Default: false (Available as backup agent)
translationobjectNoLanguage translation settings including enablement flag and target language code. Rules: (1) translation.enabled can only be true if the agent's language is not en-US; (2) when enabled, translation.language must be either the agent's language or en-US; (3) when enabled, translation.language is required.

Responses

200 - Agent updated successfully
  • id (string, required): Unique identifier for the created agent Example: 507f1f77bcf86cd799439011

  • locationId (string, required): Unique identifier for the account where this agent operates Example: LOC123456789ABCDEF

  • agentName (string, required): Display name of the voice AI agent Example: Customer Support Agent

  • businessName (string, required): Name of the business this agent represents Example: Acme Corporation

  • welcomeMessage (string, required): Greeting message spoken when the agent answers calls Example: Hello! Thank you for calling. How can I assist you today?

  • agentPrompt (string, required): Custom instructions defining the agent's behavior Example: You are a helpful customer service representative.

  • voiceId (string, required): Identifier for the speech synthesis voice being used Example: 507f1f77bcf86cd799439011

  • language (string, required): Language code for the agent's speech and understanding Example: en-US

  • patienceLevel (string, required): Current tolerance level for caller response delays Example: medium

  • maxCallDuration (number, required): Maximum call duration in seconds, between 180-900 Example: 600

  • sendUserIdleReminders (boolean, required): Indicates whether automatic idle reminders are enabled Example: True

  • reminderAfterIdleTimeSeconds (number, required): Seconds to wait before sending idle reminders, between 1-20 Example: 5

  • inboundNumber (string): Phone number for receiving inbound calls Example: +1234567890

  • numberPoolId (string): Identifier for the number pool managing this agent's phone allocation Example: pool_507f1f77bcf86cd799439011

  • callEndWorkflowIds (string[]): Array of workflow IDs triggered automatically when calls end

  • sendPostCallNotificationTo (object): Current post-call notification settings including recipient configuration

  • agentWorkingHours (object[]): Time intervals when the agent accepts calls, organized by day of week

    • dayOfTheWeek (number, required): Day of the week for this working hours configuration (Monday=1 to Sunday=7) Possible values: 1, 2, 3, 4, 5, 6, 7 Example: 1

    • intervals (object[], required): Array of time intervals when the agent is available on this day

      • startHour (number, required): Starting hour of the working interval in 24-hour format (0-23) Example: 9

      • endHour (number, required): Ending hour of the working interval in 24-hour format (0-23) Example: 17

      • startMinute (number, required): Starting minute of the working interval (0-59) Example: 0

      • endMinute (number, required): Ending minute of the working interval (0-59) Example: 30

  • timezone (string, required): IANA timezone identifier for working hours and scheduling Example: America/New_York

  • isAgentAsBackupDisabled (boolean, required): Indicates whether this agent is excluded from backup scenarios Example: False

  • translation (object): Current language translation settings including enablement status and target language

json
{
  "id": "507f1f77bcf86cd799439011",
  "locationId": "LOC123456789ABCDEF",
  "agentName": "Customer Support Agent",
  "businessName": "Acme Corporation",
  "welcomeMessage": "Hello! Thank you for calling. How can I assist you today?",
  "agentPrompt": "You are a helpful customer service representative.",
  "voiceId": "507f1f77bcf86cd799439011",
  "language": "en-US",
  "patienceLevel": "medium",
  "maxCallDuration": 600,
  "sendUserIdleReminders": true,
  "reminderAfterIdleTimeSeconds": 5,
  "inboundNumber": "+1234567890",
  "numberPoolId": "pool_507f1f77bcf86cd799439011",
  "callEndWorkflowIds": [],
  "agentWorkingHours": [],
  "timezone": "America/New_York",
  "isAgentAsBackupDisabled": false
}
400 - Bad Request
json
{}
401 - Unauthorized
json
{}
422 - Unprocessable Entity
json
{}

Example

curl -X PATCH 'https://services.leadconnectorhq.com/voice-ai/agents/YOUR_agentId' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "agentName": "Customer Support Agent",
  "businessName": "Acme Corporation",
  "welcomeMessage": "Hello! Thank you for calling Acme Corporation. How can I assist you today?",
  "agentPrompt": "You are a helpful customer service representative. Always be polite and professional.",
  "voiceId": "507f1f77bcf86cd799439011",
  "language": "en-US",
  "patienceLevel": "low",
  "maxCallDuration": 600,
  "sendUserIdleReminders": true,
  "reminderAfterIdleTimeSeconds": 5,
  "inboundNumber": "+1234567890",
  "numberPoolId": "pool_507f1f77bcf86cd799439011",
  "callEndWorkflowIds": [
    "wf_507f1f77bcf86cd799439011",
    "wf_507f1f77bcf86cd799439012"
  ],
  "agentWorkingHours": [
    {
      "dayOfTheWeek": 1,
      "intervals": [
        {
          "startHour": 9,
          "startMinute": 0,
          "endHour": 17,
          "endMinute": 30
        }
      ]
    }
  ],
  "timezone": "America/New_York",
  "isAgentAsBackupDisabled": false
}'

Last updated October 26, 2026

Was this page helpful?