Skip to main content

GET Action Items

This API returns list of all the action items generated from the conversation.

An action item is a specific outcome recognized in the conversation that requires one or more people in the conversation to act in the future.

These actions can be definitive in nature and owned with a commitment to working on a presentation, sharing a file, completing a task, etc. Or they can be non-definitive like an idea, suggestion or an opinion that could be worked upon.

All action items are generated with action phrases, assignees and due dates so that you can build workflow automation with your own tools.

HTTP Request#

GET https://api.symbl.ai/v1/conversations/{conversationId}/action-items

Example API call#

curl "https://api.symbl.ai/v1/conversations/$CONVERSATION_ID/action-items" \
-H "Authorization: Bearer $AUTH_TOKEN"

Response#

{
"actionItems": [
{
"id": "5707174000984064",
"text": "Roger is going to work with the TV lab and make sure that test is also included, so we are checking to make sure not only with our complaints.",
"type": "action_item",
"score": 0.9999962500210938,
"messageIds": [
"6531517035527344"
],
"phrases": [
{
"type":"action_phrase",
"text":"Roger is going to work with the TV lab"
}
],
"definitive": true,
"entities": [],
"assignee": {
"name": "Roger",
"email": "Roger@example.com"
}
},
{
"id": "5633940379402240",
"text": "Mary thinks we need to go ahead with the TV in Bangalore.",
"type": "action_item",
"score": 0.8659442937321238,
"messageIds": [
"4972726972317696"
],
"phrases": [],
"definitive": false,
"entities": [],
"assignee": {
"name": "Mary",
"email": "Mary@example.com"
}
},
{
"id": "5690029162627072",
"text": "Checking the nodes with Eisner to make sure we covered everything so that will be finished.",
"type": "action_item",
"score": 0.8657734634985154,
"messageIds": [
"6531517035577244"
],
"phrases": [
{
"type": "action_phrase",
"text": "Checking the nodes with Eisner to make sure we covered everything"
}
],
"definitive": true,
"entities": [],
"assignee": {
"name": "Eisner",
"email": "Eisner@example.com"
}
},
{
"id": "5757280188366848",
"text": "Mary thinks it really needs to kick start this week which means the call with UV team and our us team needs to happen the next couple of days.",
"type": "action_item",
"score": 0.9999992500008438,
"messageIds": [
"6521517035577344"
],
"phrases": [],
"definitive": false,
"entities": [],
"assignee": {
"name": "Mary",
"email": "Mary@example.com"
},
"dueBy": "2020-02-10T07:00:00.000Z"
}
]
}

Response Object#

FieldDescription
idUnique conversation identifier.
textConversation text.
typeResponse type. Default is action_item.
scoreConfidence score of the generated topic. Value from 0 - 1.
messageIdsUnique message identifiers of the corresponding messages.
entitiesList of detected entity objects in the insight with type - entity type and text - corresponding text.
definitiveBoolean indicating if the action-item is definitive or not.
phrasesList of detected phrases with type - phrase type and text - corresponding text. The action_phrase type represents the actionable part of an insight.
assigneeThis field contains the name and email of the person assigned to the Action Item.