Update an existing action for a voice AI agent. Modifies the behavior and configuration of an agent action.

http
PUT https://services.leadconnectorhq.com/voice-ai/actions/{actionId}

Authorization

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

Path parameters

NameTypeRequiredExampleDescription
actionIdstringYesUnique identifier for the action

Body

NameTypeRequiredExampleDescription
agentIdstringYes507f1f77bcf86cd799439011Agent ID to attach the action to
locationIdstringYes507f1f77bcf86cd799439012Account ID
actionTypestringYesCALL_TRANSFERType of action Possible values: 'CALL_TRANSFER', 'DATA_EXTRACTION', 'IN_CALL_DATA_EXTRACTION', 'WORKFLOW_TRIGGER', 'SMS', 'APPOINTMENT_BOOKING', 'CUSTOM_ACTION', 'KNOWLEDGE_BASE'
namestringYesTransfer to ManagerHuman-readable name for this action
actionParametersobjectYesAction parameters - structure varies by actionType

Responses

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

  • actionType (string, required): Type of action Possible values: 'CALL_TRANSFER', 'DATA_EXTRACTION', 'IN_CALL_DATA_EXTRACTION', 'WORKFLOW_TRIGGER', 'SMS', 'APPOINTMENT_BOOKING', 'CUSTOM_ACTION', 'KNOWLEDGE_BASE' Example: CALL_TRANSFER

  • name (string, required): Human-readable name for this action Example: Transfer to Manager

  • actionParameters (object, required): Action parameters - structure varies by actionType

json
{
  "id": "507f1f77bcf86cd799439011",
  "actionType": "CALL_TRANSFER",
  "name": "Transfer to Manager"
}
400 - Bad Request
json
{}
401 - Unauthorized
json
{}
422 - Unprocessable Entity
json
{}

Example

curl -X PUT 'https://services.leadconnectorhq.com/voice-ai/actions/YOUR_actionId' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "agentId": "507f1f77bcf86cd799439011",
  "locationId": "507f1f77bcf86cd799439012",
  "actionType": "CALL_TRANSFER",
  "name": "Transfer to Manager"
}'

Last updated October 26, 2026

Was this page helpful?