`get_suggestion`

Get a single suggested action by id, including its full context blob (investigation findings, target entity, expected outcome).

Parameters#

Name	Type	Required	Description
`suggestion_id`	string	yes	The suggestion id (e.g. `"saction_abc123"`)

Returns#

json

{
  "suggestion": {
    "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": { },
    "context": { },
    "source_assistant_id": "assistant_…",
    "source_thread_id": null,
    "expires_at": null,
    "created_at": "2026-07-08T10:00:00+00:00"
  },
  "source": "adlyse.suggestions@v1"
}

Errors#

`error_type`	When
`auth_error`	Missing / invalid API key
`not_found`	No suggestion with that id in your org