List recommendations

A paginated list of recommendations. Filter by lifecycle state. State-filtered pages fill from bounded batches, so keep paging until the cursor is null.

GET/v1/recommendations

Example

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

Query Parameters

status?string

Filter by lifecycle status. Omitted: everything except archived.

Valuesopen, accepted, dismissed, shipped, validated, stale, archived

state?string

Deprecated alias of status; status wins when both are sent.

Valuesopen, accepted, dismissed, shipped, validated, stale, archived

limit?integer

Maximum number of results to return.

Default20Range1-50

cursor?string

Pagination cursor from the previous response.

Response

{  "data": [    {      "recommendationId": "rec_456",      "title": "Add an inline setup checklist",      "lifecycleState": "accepted",      "confidence": "high",      "signals": [        {          "ref": "SIG-14",          "label": "Teams want faster onboarding feedback"        }      ],      "updatedAt": 1764700000000    }  ],  "cursor": null,  "total": 1}