Skip to content
Median
Esc
↑↓navigate↵open⌘Jpreview

List tasks

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

GET/tasks
Authorization
AuthorizationBearer token · headerrequired
`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.
Query parameters
statusstring
Allowed:requestsplannedin_progressin_reviewdone
assigneestring
A teammate's identity key or their email address.
limitinteger
max 100 · default: 100
Responses
200The cards.
tasksTask[]
Show properties
Array of Task
idstring
keystring
What a commit message says: "MED-12".
numberinteger
titlestring
descriptionstring
The write-up, as markdown.
statusstring
Allowed:requestsplannedin_progressin_reviewdone
prioritystring | null
Allowed:urgenthighmediumlownull
assigneeobject | null
Show properties
userIdstring
namestring
emailstring | null
createdByNamestring
createdAtinteger
updatedAtinteger
doneAtinteger | null
signalIdstring | null
The report it was adopted from, for `GET /v1/signals/{id}`.
linearobject | null
Show properties
identifierstring
urlstring
githubobject | null
Show properties
numberinteger
urlstring
commitsinteger
pullRequestsinteger
urlstring | null
The card's page, or null where no board address is set.
400The request is malformed, and the message names the field.
errorobject
Show properties
codestring
messagestring
401The bearer token is missing, revoked, or expired.
errorobject
Show properties
codestring
messagestring
429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).
errorobject
Show properties
codestring
messagestring
Request
curl -X GET "https://api.median.sh/v1/tasks" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "tasks": [
    {
      "id": "string",
      "key": "string",
      "number": 0,
      "title": "string",
      "description": "string",
      "status": "requests",
      "priority": "urgent",
      "assignee": {
        "userId": "string",
        "name": "string",
        "email": "string"
      },
      "createdByName": "string",
      "createdAt": 0,
      "updatedAt": 0,
      "doneAt": 0,
      "signalId": "string",
      "linear": {
        "identifier": "string",
        "url": "string"
      },
      "github": {
        "number": 0,
        "url": "string"
      },
      "commits": 0,
      "pullRequests": 0,
      "url": "string"
    }
  ]
}