Annotate a call - note, flag or mark as handled

The account owner's own annotation on a call - a note, flagging the agent with a reason, and manual "handled". At least one of the three fields must be present. note (string or null, max 2000 characters) - null clears the note. flag ({reason} max 500 characters, or null) - setting a flag CLEARS handledAt (a flagged call is no longer "handled"); flag: null clears the flag without changing handled. handled (boolean) - true sets handledAt to now, false resets it to null. flag (non-null) and handled: true cannot both be set in the SAME request (400 validation) - flagging and confirmed handling are mutually exclusive; send them in two calls.

patch/v1/calls/{id}

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/calls/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

notestring nullable

Private account note about the call. null or an empty string clears it; omission preserves it.

handledboolean

true marks the call handled; false clears the handled timestamp. Omission leaves the state unchanged.

Response

Call detail

stillRunningboolean

Changes

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