Browse docslist_action_items
list_action_items
Lists Gravity's current suggestions for you, newest first, as Home shows them under From Gravity.
Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false
When to use it#
For "what does Gravity suggest I do?", or before marking a suggestion done with complete_action_item. Suggestions are Gravity's ideas for the member to consider, not tasks the member adopted or promises to anyone. Suggestions the member set aside or marked done aren't listed.
Give each suggestion's link, which opens a private conversation with Gravity about it. Don't contact anyone on the member's behalf.
Inputs#
No inputs.
Returns#
{ "actionItems": [...] }, newest first. Each suggestion has:
| Field | Type | Description |
|---|---|---|
id | string | Suggestion ID, for complete_action_item |
case | string | receive_help, help_directly, connect_people, or goal_help; identifies the kind of help offered |
title | string | The suggestion |
detail | string | Gravity's reason for it |
status, availability | string | Current list entries are active and available |
source | object or null | { kind, id, text } identifies the associated goal or pursuit |
history | object, optional | Recorded interaction events, with private assessment changes omitted |
link | string, optional | Opens Gravity's conversation about this suggestion |
Example#
json
{}
Result (synthetic data):
json
{
"actionItems": [
{
"id": "00000000-0000-4000-a000-0000000000a1",
"case": "receive_help",
"title": "Ask Synthetic Pat how their team chose its first design partners",
"detail": "Pat ran a design-partner program last year, the step this goal is on.",
"status": "active",
"availability": "available",
"source": { "kind": "goal", "id": "00000000-0000-4000-a000-000000000001", "text": "Find design partners" },
"link": "https://www.meetgravity.ai/dashboard/action-items/00000000-0000-4000-a000-0000000000a1"
}
]
}
Related#
complete_action_itemmarks a suggestion done when the member says they did it.list_introductionslists introductions waiting on the member.