Skip to content
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:

FieldTypeDescription
idstringSuggestion ID, for complete_action_item
casestringreceive_help, help_directly, connect_people, or goal_help; identifies the kind of help offered
titlestringThe suggestion
detailstringGravity's reason for it
status, availabilitystringCurrent list entries are active and available
sourceobject or null{ kind, id, text } identifies the associated goal or pursuit
historyobject, optionalRecorded interaction events, with private assessment changes omitted
linkstring, optionalOpens 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"
    }
  ]
}