PATCH /tasks/{task}
Updated Oct 1, 20261 minute read
Update a task
The words, the facts, or the column. null clears the priority or takes the card off whoever has it. A move to done closes the report the card came from, which messages everybody who asked for it, and closes the issues mirroring it.
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. |
Request body
application/json, required.
| Field | Type | Required | Description |
|---|---|---|---|
title | string | No | |
description | string | No | |
priority | "urgent" | "high" | "medium" | "low" | null | No | |
assignee | any | No | A teammate's identity key or their email address. Null takes the card off everybody. |
status | "requests" | "planned" | "in_progress" | "in_review" | "done" | No | |
place | "top" | "bottom" | No | Where in the new column the card lands. The bottom of it by default, and only read alongside status. |
Responses
| Status | Description |
|---|---|
200 | Done. |
400 | The request is malformed, and the message names the field. |
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. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean | No |
Example response
{
"ok": true
}Example request
curl -X PATCH https://api.median.sh/v1/tasks/task \
-H "Authorization: Bearer $BEARER_AUTH" \
-H "content-type: application/json" \
-d '{"status":"in_review"}'