Save the human-agent call wrap-up disposition

Sets call_logs.call_disposition for the matching call_sid (workspace-scoped) and mirrors the value into structured_outputs.call_disposition so the unified_calls view + Voice AI Human Agent dashboard surface it without a view change. Vocabulary aligns with vapi_call_records.call_disposition (APPOINTMENT_SET, CALLBACK_SCHEDULED, VOICEMAIL_LEFT, NO_ANSWER, NOT_INTERESTED, DO_NOT_CALL_HONORED, ...).

PUT

https://api.channelautomation.com/api/calls/{callSid}/disposition

Path parameters

callSid
string
required

Request body JSON required

workspace_id
string
required
disposition
string
required
user_id
optional
string
cadence_request
optional
object
Optional manager-approved retry timing; validated atomically for managed calls. Does not change the call result.
- wait_minutes
  optional
  integer
  minimum: 1
- retry_at
  optional
  string
  format: date-time
- reason
  optional
  string
  maxLength: 500
}
callback_at
optional
string
Future promised callback time when disposition is CALLBACK_SCHEDULED.

format: date-time
sub_disposition
optional
string

Returns

200

Disposition saved

400

Missing workspace_id or disposition

404

No call_logs row for that call_sid in the workspace

500

Server error

Save the human-agent call wrap-up disposition

curl --request PUT \
  --url 'https://api.channelautomation.com/api/calls/<callSid>/disposition' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_id": "string",
  "disposition": "string",
  "user_id": "string",
  "cadence_request": {
    "wait_minutes": 1,
    "retry_at": "2019-08-24T14:15:22Z",
    "reason": "string"
  },
  "callback_at": "2019-08-24T14:15:22Z",
  "sub_disposition": "string"
}
'

const url = 'https://api.channelautomation.com/api/calls/<callSid>/disposition';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    workspace_id: 'string',
    disposition: 'string',
    user_id: 'string',
    cadence_request: {wait_minutes: 1, retry_at: '2019-08-24T14:15:22Z', reason: 'string'},
    callback_at: '2019-08-24T14:15:22Z',
    sub_disposition: 'string'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/calls/<callSid>/disposition"

payload = {
    "workspace_id": "string",
    "disposition": "string",
    "user_id": "string",
    "cadence_request": {
        "wait_minutes": 1,
        "retry_at": "2019-08-24T14:15:22Z",
        "reason": "string"
    },
    "callback_at": "2019-08-24T14:15:22Z",
    "sub_disposition": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.text)