Median

POST /tasks/requests/{id}

Updated Oct 1, 20261 minute read

Put a request on the board

The card carries the report's words, its priority and whichever tracker issues the report already holds. From here on the two move together, so marking the card done is what tells everybody who asked for it.

Part of Tasks.

Parameters

NameInTypeRequiredDescription
idpathstringYesA signal id.

Request body

application/json, optional.

FieldTypeRequiredDescription
status"requests" | "planned" | "in_progress" | "in_review" | "done"No

Responses

StatusDescription
200The card.
400The request is malformed, and the message names the field.
401The bearer token is missing, revoked, or expired.
404Not one of yours, or not there at all.
409It already exists, or it was already settled.
429Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits.

200 body

FieldTypeRequiredDescription
idstringNo
keystringNo
numberintegerNo

Example response

{
  "id": "k97a2fh3m1x8p4qv6r2t9w5y",
  "key": "MED-12",
  "number": 12
}

Example request

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

Still need help?

    Esc