get_task
Fetch task details, status, human-gate state, comments, artifacts, VCS links, and dependencies for agent coordination.
Instructions
Get task details: compact decision fields, active human_gate=true and status slug; descriptions and ordinary comment bodies are always complete. Comment IDs support reply/after; timestamps are UTC to the minute. Known automation comments are one-line summaries (include_auto=true restores their complete bodies). full=true restores non-capability REST fields. If status lookup is unavailable, status_id and an explicit status_lookup_error remain. Comments return the newest comments_limit entries (default 5, max 200) with pagination markers. Use since=RFC3339 from task.updated_at to avoid repeating an unchanged task and older comments.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Return the task (full description, non-capability fields, whole inline comments) instead of the compact view (default false). | |
| since | No | RFC3339 timestamp from an earlier call in this session (e.g. that response's task.updated_at, or your own last-call time). With it: include_comments returns only comments created after it, and the full task body (description and the rest) is included only if the task's own updated_at is after it too — the response then carries task_changed=true/false so you always know which you got, and a trimmed stub (id/status/assignee_name/updated_at in compact reads; status_id plus status_lookup_error if lookup fails, or the original status_id and assignee fields with full=true) instead of the full task when nothing changed, to avoid re-paying for the same ~5k tokens on a repeat call. Omit for the unfiltered default: full task body, but the comment tail still obeys comments_limit (default 5, max 200) — a longer thread needs list_comments paging. | |
| task_id | Yes | Task ID (full UUID or 6–12 char hex short-ID prefix). | |
| include_auto | No | Return complete automation bodies in compact mode (ordinary comments are always complete). | |
| comments_limit | No | How many of the NEWEST comments to include when include_comments=true (default 5, max 200). The tail is where an acting agent looks first; raise it when you need more of it. The API caps any single request at 200 — a longer thread is only readable end-to-end by paging list_comments (order=desc, page=N), never by one call here. | |
| include_comments | No | Include the task's most recent comments (see comments_limit for how many; the response carries comments_total_count and comments_has_more so a longer thread is never silently hidden). | |
| include_artifacts | No | Include artifacts. | |
| include_vcs_links | No | Include linked PRs/MRs/commits/branches (id, provider, link_type, external_id, url, status, created_at) — use this instead of a raw REST call to diagnose a misclassified or stuck-status link. | |
| include_dependencies | No | Include dependencies. |