List action cards

The team's inbox: pending action cards ranked by priority tier (1 = most urgent), then per-item urgency, then newest first. Page through the queue with the cursor.

GET/v1/action-cards

Example

curl -X GET "https://silent-viper-157.convex.site/v1/action-cards" \  -H "Authorization: Bearer $ASKENGINE_API_KEY"

Query Parameters

limit?integer

Maximum cards to return. Defaults to 20; maximum 50.

Default20Range1-50

cursor?string

The cursor the previous page handed back.

type?string

Filter by action card type.

Valuesfix_contradicted, new_recommendation, live_call, cross_study_signal, research_gap, follow_up_suggestion, low_balance, theme_contradiction, study_saturation, interview_failure

Response

{  "data": [    {      "actionCardId": "card_123",      "type": "new_recommendation",      "summary": "AskEngine recommends adding verification cues to flight results.",      "priority": 1,      "createdAt": 1767312000000,      "refs": {        "recommendationId": "rec_456",        "studyIds": [          "study_789"        ]      },      "studies": [        {          "studyId": "study_789",          "name": "Post-use impressions"        }      ]    }  ],  "cursor": null,  "total": 1}