Action items

Use the Conversations API to identify an action item as a specific task from the conversation. Action items usually require one or more people to do something like schedule a meeting, share a file, or complete a task.

Action items provide the insights of who needs to do what, by when. The definition of when is optional when identifying action items.

For example:

  • "I will complete the management presentation by the end of today." Here, a person is committing to complete the presentation (task) by the end of the day.

  • "I will make sure that all the bugs are fixed before the start of the next Sprint." Here, the person is committing to fix the relevant bugs in a specific window of time.

Action items have the ability to:

  • Recognize the assignee and assignor of an action item when possible.

  • Recognize the date and time, if specified in the Insight.

  • Use speaker context to enhance the quality of the insights. For example, if speaker events are passed and the algorithm knows which speaker is speaking, it changes "I will defend the North till the end of the day" to "John Snow will defend the North till the end of the day."

  • Use timezone to calculate accurate date and time references. If timezone details are passed in the API call and a known speaker says "I will defend the North till the end of the day", in action item response the dueBy time appears as dueBy: "2020-02-10T07:00:00.000Z".

  • Control the confidence threshold for the insight. The confidence threshold is a number between 0.0 and 1.0 where a decimal value closer to 1.0 means the detected phrase is an Action Item.


This request requires an access token, as described in Authenticate.

Get action items

This section describes how to get action items from a conversation. This request requires a conversation ID. You receive a conversation ID when you process a conversation with the APIs.

To get action items, use the following operation:


To make this request from the API reference, see Get action items.