voice

Record Call Disposition

How this call ended, said by the person who was on it.

Frederick, 2026-09-17: "At the end of the call, it should force you to do a disposition on the ticket... And then that also will tell Rooster how the call ended."

⛔THE CLAIM IS ALWAYS RECORDED; THE TICKET MOVING IS A CONSEQUENCE. 77 of 142 calls in production carry no ticket at all, because somebody rang and asked nothing -- so a disposition that required one would not exist for the majority of calls, and the Rooster-learning half of this would be missing its larger part.

⛔AND IT APPENDS RATHER THAN REPLACING. If Rooster ever dispositions a call and a human later disagrees, BOTH rows survive -- that disagreement is the training signal this exists to collect.

⛔THE PATH CARRIES call_uuid, THE SAME ID AS ITS FOUR SIBLINGS. It was {call_id} -- the only one of the five /calls/{...} routes spelled that way -- and it meant the internal primary key, which no browser has. Every caller of this route sends what the Plivo SDK gave it, so the route that asked for something else answered 404 to every well-formed request.

422 on a word outside the seven an agent may choose (voice.domain. CHOOSABLE_CALL_DISPOSITIONS -- as of 2026-09-22, this is no longer the same six as CALL_DISPOSITIONS itself, which still accepts two retired words for historical rows), rather than letting the database's CHECK answer with a 500: an agent picking from a list should never see a server error, and the message names the word.

post/api/voice/calls/{call_uuid}/disposition

Request

  • Base URL: https://api.pigeonly.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pigeonly.com/api/voice/calls/{call_uuid}/disposition
  • Auth: none declared

Path parameters

call_uuidstring required

Request body

dispositionstring required
notesstring nullable
request_idstring nullable
requested_callback_atstring date-time nullable

Response

Successful Response

disposition_idstring required
ticket_idstring nullable required
ticket_moved_tostring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.