Create/Update the annotation for the call in Twilio Insights
A documented Twilio Insights operation that changes something in your account. Describe the outcome you want in plain words — HumDay writes the program, proves it, and runs it.
What this operation does
Create/Update the annotation for the call
- POSTChanges data
insights.twilio.com/v1/Voice/{CallSid}/Annotation
How HumDay uses it
- You describe the outcome. Not this operation by name — what you want to happen. HumDay works out which operations it needs.
- The contract names it. Before anything is built, you see exactly which Twilio Insights operations the program may use, and this is one of them.
- You approve access. Because this one changes data, it cannot run until you have explicitly granted it.
Other Twilio Insights operations
- Retrieve a list of ConferencesGET · reads data
- Get a list of Programmable Video RoomsGET · reads data
- List Conference ParticipantsGET · reads data
- Get a list of room participantsGET · reads data
- Fetch a specific ConferenceGET · reads data
- Get Video Log Analyzer data for a RoomGET · reads data
- Fetch a specific AnnotationGET · reads data
- Fetch a specific Conference Participant SummaryGET · reads data
Questions
- Can HumDay create/update the annotation for the call in Twilio Insights?
- Yes. This operation is published in Twilio Insights's own API description, so HumDay can use it without a hand-built connector — once you have approved it for your automation.
- Will this change my Twilio Insights data?
- Yes — this is a POST operation, so it changes something in Twilio Insights. HumDay holds anything that writes behind an approval you grant explicitly, and the contract you approve says what it may touch.
- Do I need to write code?
- No. You describe the outcome you want in plain words. HumDay agrees a contract with you, writes the program, and shows you a proof run before anything touches your Twilio Insights account.
Where this came from
Read from a published API description for Twilio Insights at raw.githubusercontent.com/twilio/twilio-oai/main/spec/json/twilio_insights_v1.json. The description above is the provider’s own wording, not ours. Last published 2023-04-20.