GET /tasks

Updated Oct 1, 20261 minute read

List tasks

One column in order, or the whole board left to right. Done comes back newest first.

Part of Tasks.

Parameters

Name	In	Type	Required	Description
`status`	query	`"requests" \| "planned" \| "in_progress" \| "in_review" \| "done"`	No
`assignee`	query	`string`	No	A teammate's identity key or their email address.
`limit`	query	`integer`	No

Status	Description
`200`	The cards.
`400`	The request is malformed, and the message names the field.
`401`	The bearer token is missing, revoked, or expired.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`tasks`	`object[]`	No
`tasks[].id`	`string`	No
`tasks[].key`	`string`	No	What a commit message says: "MED-12".
`tasks[].number`	`integer`	No
`tasks[].title`	`string`	No
`tasks[].description`	`string`	No	The write-up, as markdown.
`tasks[].status`	`"requests" \| "planned" \| "in_progress" \| "in_review" \| "done"`	No
`tasks[].priority`	`"urgent" \| "high" \| "medium" \| "low" \| null`	No
`tasks[].assignee`	`object`	No
`tasks[].assignee.userId`	`string`	No
`tasks[].assignee.name`	`string`	No
`tasks[].assignee.email`	`any`	No
`tasks[].createdByName`	`string`	No
`tasks[].createdAt`	`integer`	No
`tasks[].updatedAt`	`integer`	No
`tasks[].doneAt`	`any`	No
`tasks[].signalId`	`any`	No	The report it was adopted from, for `GET /v1/signals/{id}`.
`tasks[].linear`	`object`	No
`tasks[].linear.identifier`	`string`	No
`tasks[].linear.url`	`string`	No
`tasks[].github`	`object`	No
`tasks[].github.number`	`integer`	No
`tasks[].github.url`	`string`	No
`tasks[].commits`	`integer`	No
`tasks[].pullRequests`	`integer`	No
`tasks[].url`	`any`	No	The card's page, or null where no board address is set.

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