Median

POST /signals

Updated Oct 1, 20261 minute read

File a signal

Files one by hand. A title already on the list is refused out loud with signal_exists, naming the twin.

Part of Signals.

Request body

application/json, required.

FieldTypeRequiredDescription
kind"bug" | "suggestion"Yes
titlestringYes
bodystringNo
priority"urgent" | "high" | "medium" | "low"Yes
conversationIdstringNoThe inbox conversation it came out of, when it did. The customer in that thread becomes the signal's first reporter and is told when it ships.

Responses

StatusDescription
200Created.
400The request is malformed, and the message names the field.
401The bearer token is missing, revoked, or expired.
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

Example request

curl -X POST https://api.median.sh/v1/signals \
  -H "Authorization: Bearer $BEARER_AUTH" \
  -H "content-type: application/json" \
  -d '{"kind":"bug","title":"Export breaks past 10k rows","body":"The CSV export times out for large workspaces.","priority":"high"}'

Still need help?

    Esc