Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-05-061774283.2 KB
InsightsV1Annotation

Update an Annotation for a specific Call.

Update an Annotation for a specific Call.

post/v1/Voice/{CallSid}/Annotation

Path parameters

CallSidstring required

The unique string that Twilio created to identify this Call resource. It always starts with a CA.

Response

OK

call_sidstring nullable

The unique SID identifier of the Call.

account_sidstring nullable

The unique SID identifier of the Account.

answered_by'unknown_answered_by' | 'human' | 'machine'
connectivity_issue'unknown_connectivity_issue' | 'no_connectivity_issue' | 'invalid_number' | 'caller_id' | 'dropped_call' | 'number_reachability'
quality_issuesstring[] nullable

Specifies if the call had any subjective quality issues. Possible values are one or more of no_quality_issue, low_volume, choppy_robotic, echo, dtmf, latency, owa, or static_noise.

spamboolean nullable

Specifies if the call was a spam call. Use this to provide feedback on whether calls placed from your account were marked as spam, or if inbound calls received by your account were unwanted spam. Is of type Boolean: true, false. Use true if the call was a spam call.

call_scoreinteger nullable

Specifies the Call Score, if available. This is of type integer. Use a range of 1-5 to indicate the call experience score, with the following mapping as a reference for rating the call [5: Excellent, 4: Good, 3 : Fair, 2 : Poor, 1: Bad].

commentstring nullable

Specifies any comments pertaining to the call. Twilio does not treat this field as PII, so no PII should be included in comments.

incidentstring nullable

Incident or support ticket associated with this call. The incident property is of type string with a maximum character limit of 100. Twilio does not treat this field as PII, so no PII should be included in incident.

urlstring uri nullable