Task card
A single collapsible task with a status, details, output, and sources.
task_card shows one task’s progress: what it’s doing, what it produced, and where that came from.
It’s a Slack block documented for agent surfaces,
newer than the version of @slack/types this library depends on, so its TypeScript type is the field
reference here. It’s read-only: expanding a task card doesn’t emit an action. Use plan instead when
you have several tasks under one shared goal.
Click the pill to expand the card and see its details, output, and sources.
Fields
typestring
Always `task_card`.
stringtask_idstring
Identifies the task.
stringtitlestring
The task's one-line summary, shown in the collapsed pill.
stringstatus"pending" | "in_progress" | "complete" | "error"
The task's state. The status icon distinguishes `complete` and `in_progress`; `pending` and `error` currently render the same dashed-circle icon.
"pending" | "in_progress" | "complete" | "error"details?RichTextBlock
What the task is doing, shown when the card is expanded.
RichTextBlockoutput?RichTextBlock
The task's result, shown below `details`.
RichTextBlocksources?{ type: "url"; url: string; text?: string }[]
Links shown under the task, opened in a new tab. `text` defaults to the raw URL.
{ type: "url"; url: string; text?: string }[]Examples
In progress, with a rich text link
The preview above’s details field mixes a plain text run with a link element inside a rich text
section.
Complete
Minimal: title and status only
details, output, and sources are all optional. A bare task card shows just its status and title.