calls

Answer a mid-call question

Changed on

Answer a question the agent asked mid-call. If no answer arrives before the wait window elapses, the call proceeds and wraps up.

post/calls/{call_id}/answer

Request

  • Base URL
    https://api.voygr.tech
  • URL
    https://api.voygr.tech/calls/{call_id}/answer
  • Auth
    API key in header X-API-Key

Path parameters

call_idstring required

Request body

answerstring nullable

Free text the bot will say to the operator. Mutually exclusive with outcome.

mode'voice'

'voice' (default): the bot speaks answer aloud to the operator. It is the only accepted value for an answer: an answer sent with 'context' is refused with 422 unsupported_mode and the question stays open. An outcome ignores the mode.

outcome'timeout' | 'transport_failure' nullable

Closed client-side outcome when the observed ask_user request cannot receive an answer. Requires request_id. Mutually exclusive with answer.

request_idstring nullable

Disambiguates which pending ask_user this answers, when several are in flight on the same call. Required when outcome is set; optional with answer (when omitted, the answer goes to the oldest pending question).

Response

Successful Response

deliveredboolean required

True if a transport was actively waiting on this call_id when the answer arrived. False means the ask_user already timed out, the call ended, or no ask_user was pending: the answer is dropped without an error.

reason'delivered' | 'no_pending_request' required

'delivered': a transport took the answer. 'no_pending_request': nothing was pending under this request_id (already answered, expired after about 60s, or unknown), so the answer was dropped. This is not an error; a stale retry lands here safely.

Changes

    • breaking

      removed subschema #1 subschema #2 from the request body oneOf list

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status