list_suggestions
List AI-generated suggested actions for the organization — the same cards surfaced in the Adlyse dashboard sidebar, produced by the suggestion pipeline (e.g. pause a wasteful campaign, raise a budget). Cards from an in-flight pipeline run are hidden so you only see adjudicated rows. Ordered urgent → low, then newest first.
Use get_suggestion for one card’s full context. Accepting/executing a suggestion is done in the Adlyse dashboard.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
status | string | no | pending | accepted | rejected | executed | expired | |
priority | string | no | urgent | high | medium | low | |
action_type | string | no | ActionRegistry type filter (e.g. "UPDATE_BUDGET") | |
limit | integer | no | 50 | Max cards (max 200) |
offset | integer | no | 0 | Pagination offset |
Returns#
json
{
"suggestions": [
{
"id": "saction_abc123",
"title": "Pause campaign 'Brand – Broad'",
"rationale": "14d CPA is $112 vs $40 target…",
"priority": "high",
"status": "pending",
"confidence_score": 0.9,
"action_type": "PAUSE_ENTITY",
"action_data": { },
"source_assistant_id": "assistant_…",
"source_thread_id": null,
"expires_at": null,
"created_at": "2026-07-08T10:00:00+00:00"
}
],
"total": 12,
"offset": 0,
"limit": 50,
"has_more": false,
"source": "adlyse.suggestions@v1"
}The list view omits each card’s (potentially large) context blob — fetch it via get_suggestion.
Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |