task

A work item — issue, ticket, or to-do. Supports hierarchy (parent/children) and dependency tracking (blocked_by/blocks).

Metadata	Value
Plural	tasks
Subtitle field	state
Identity	platform, id

Fields

Field	Type
remoteId	string
priority	integer
state	string
labels	string[]
startedAt	datetime
targetDate	datetime

Relations

Relation	Target
assignedTo	person
project	project
repository	repository
parent	task
children	task[]
blockedBy	task[]
blocks	task[]

Used as a base by

• spec

Prior art

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

• GitHub REST API — Issues — Direct source. Our remoteId/state/labels/assignedTo/parent/ children/blockedBy/blocks map to GitHub Issue + sub-issues + task-list tracking.
• Linear GraphQL API — Issue — Practical canonical. Our priority/state/project/targetDate align with Linear’s Issue model exactly.
• Todoist REST API v2 — Tasks — Consumer-grade task model. Our startedAt/targetDate ≈ created_at/due; labels match directly.

Skills that produce this shape

• todoist — list_tasks, list_all_tasks, filter_task, get_task, create_task, update_task, move_task
• linear — list_tasks, get_task, create_task, update_task
• github — list_tasks, get_task