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

List a task's comments

Every comment on the card, oldest first.

GET/tasks/{task}/comments
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.
Path parameters
taskstringrequired
A task key like "MED-12", its number, its id, or a link to the card.
Responses
200The comments.
commentsTaskComment[]
Show properties
Array of TaskComment
idstring
authorobject
Show properties
userIdstring
`api` for a Median key.
namestring
imageUrlstring | null
agentobject | null
The coding agent that wrote it, when one did.
Show properties
namestring
labelstring
bodystring
mentionsobject[]
Show properties
Array of object
userIdstring
namestring
createdAtinteger
editedAtinteger | null
401The bearer token is missing, revoked, or expired.
errorobject
Show properties
codestring
messagestring
404Not one of yours, or not there at all.
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/string/comments" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "comments": [
    {
      "id": "string",
      "author": {
        "userId": "string",
        "name": "string",
        "imageUrl": "string"
      },
      "agent": {
        "name": "string",
        "label": "string"
      },
      "body": "string",
      "mentions": [
        {
          "userId": "string",
          "name": "string"
        }
      ],
      "createdAt": 0,
      "editedAt": 0
    }
  ]
}