GET /tasks/{task}

Updated Oct 1, 20261 minute read

Get a task

One card, and every commit and pull request that named it, newest first.

Part of Tasks.

Parameters

Name	In	Type	Required	Description
`task`	path	`string`	Yes	A task key like "MED-12", its number, its id, or a link to the card.

Status	Description
`200`	The card.
`401`	The bearer token is missing, revoked, or expired.
`404`	Not one of yours, or not there at all.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`id`	`string`	No
`key`	`string`	No	What a commit message says: "MED-12".
`number`	`integer`	No
`title`	`string`	No
`description`	`string`	No	The write-up, as markdown.
`status`	`"requests" \| "planned" \| "in_progress" \| "in_review" \| "done"`	No
`priority`	`"urgent" \| "high" \| "medium" \| "low" \| null`	No
`assignee`	`object`	No
`assignee.userId`	`string`	No
`assignee.name`	`string`	No
`assignee.email`	`any`	No
`createdByName`	`string`	No
`createdAt`	`integer`	No
`updatedAt`	`integer`	No
`doneAt`	`any`	No
`signalId`	`any`	No	The report it was adopted from, for `GET /v1/signals/{id}`.
`linear`	`object`	No
`linear.identifier`	`string`	No
`linear.url`	`string`	No
`github`	`object`	No
`github.number`	`integer`	No
`github.url`	`string`	No
`commits`	`integer`	No
`pullRequests`	`integer`	No
`url`	`any`	No	The card's page, or null where no board address is set.
`code`	`object[]`	No	Every commit and pull request that named the card, newest first.
`code[].kind`	`"commit" \| "pull_request"`	No
`code[].repo`	`string`	No	"owner/repo".
`code[].ref`	`string`	No	The short sha, or the pull request number.
`code[].title`	`string`	No
`code[].url`	`string`	No
`code[].author`	`string`	No
`code[].via`	`"key" \| "ai"`	No	Whether the key was in the text, or a model read the push and matched it.
`code[].state`	`"open" \| "merged" \| "closed" \| null`	No
`code[].draft`	`boolean`	No
`code[].updatedAt`	`integer`	No

curl https://api.median.sh/v1/tasks/task \
  -H "Authorization: Bearer $BEARER_AUTH"