Browse the reference
All resources
AI insights
2 endpoints
List insights in this household. By default returns undismissed only; pass includeDismissed=true to see the full archive.
GET
/households/{householdId}/ai/insightsread:insights
Parameters
| Name | In | Required |
|---|---|---|
| includeDismissed | query | Optional |
| kind | query | Optional |
| periodStart | query | Optional |
| limit | query | Optional |
| cursor | query | Optional |
Example request
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -X GET https://api.vokse.ai/households/current/ai/insightsResponse200 · Success
Dismiss an insight (idempotent)
POST
/households/{householdId}/ai/insights/{insightId}/dismisswrite:insights
Parameters
| Name | In | Required |
|---|---|---|
| insightId | path | Required |
Example request
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -H "Idempotency-Key: $(uuidgen)" \ -X POST https://api.vokse.ai/households/current/ai/insights/{insightId}/dismissResponse200 · Success