get_task_status
[AdCP Protocol] Get the status of a previously issued AdCP task.
Every AdCP task Trillboards serves for an AUTHENTICATED caller is recorded and
returned a task_id. Poll that id here to read the task's terminal state and,
with include_result: true, its completion payload.
Trillboards answers every AdCP task in-process, so a task is already
completed by the time you hold its id — this tool exists so a buyer that
polls does not hang, and so an async arm has somewhere to report from when one
lands.
TASK SCOPE: tasks are visible only to the account that created them. An id belonging to another account, an id we never issued, or a poll with no credential all answer identically — "Task not found" — so the surface cannot be used to probe which ids exist.
NOT RECORDED: read-only protocol and catalogue calls that AdCP does not model as tasks (get_adcp_capabilities, list_creative_formats, get_media_buys, list_accounts), and any anonymous call, which has no account to scope to.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | ||
| context | No | ||
| task_id | Yes | Unique identifier of the task to retrieve, as issued in the `task_id` field of the originating task response. | |
| include_result | No | Include the task's result payload when status is completed. Defaults to false for lightweight status-only polls. | |
| include_history | No | Include conversation history. Trillboards tasks complete in-process and hold no multi-turn history, so this is accepted and has no effect. |