Median

PATCH /signals/{id}

Updated Oct 1, 20261 minute read

Update a signal

Send title with an optional body to reword it, status to move it, priority to rank it, in any combination. Omitting body preserves the description; an empty string clears it. Marking it done messages everybody who reported it. Changes push through to linked tracker issues.

Part of Signals.

Parameters

NameInTypeRequiredDescription
idpathstringYesA signal id.

Request body

application/json, required.

FieldTypeRequiredDescription
titlestringNo
bodystringNo
status"open" | "planned" | "in progress" | "in review" | "done" | "declined"No
priority"urgent" | "high" | "medium" | "low"No

Responses

StatusDescription
200Done.
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.
429Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits.

200 body

FieldTypeRequiredDescription
okbooleanNo

Example response

{
  "ok": true
}

Example request

curl -X PATCH https://api.median.sh/v1/signals/id \
  -H "Authorization: Bearer $BEARER_AUTH" \
  -H "content-type: application/json" \
  -d '{"status":"done"}'

Still need help?

    Esc