GET /signals/{id}
Updated Oct 1, 20261 minute read
Get a signal
The signal, everyone who reported it with their own words, and commits that look like they finish it.
Part of Signals.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | A signal id. |
Responses
| Status | Description |
|---|---|
200 | The signal and its history. |
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 |
|---|---|---|---|
signal | object | No | |
signal.id | string | No | |
signal.kind | "bug" | "suggestion" | No | |
signal.title | string | No | |
signal.body | string | No | |
signal.priority | "urgent" | "high" | "medium" | "low" | No | |
signal.status | "open" | "planned" | "in progress" | "in review" | "done" | "declined" | No | |
signal.reporterCount | integer | No | |
signal.aliases | string[] | No | The other titles this was reported under, kept when duplicates merge. |
signal.filedAt | integer | No | |
signal.updatedAt | integer | No | |
signal.updatedByName | any | No | |
signal.linear | object | No | |
signal.linear.identifier | string | No | |
signal.linear.url | string | No | |
signal.github | object | No | |
signal.github.number | integer | No | |
signal.github.url | string | No | |
reporters | object[] | No | |
reporters[].conversations | object[] | No | |
reporters[].conversations[].conversationId | string | No | |
reporters[].conversations[].subject | string | No | |
reporters[].who | string | No | |
reporters[].quote | string | No | What the customer actually said, in their own words. |
reporters[].reportedAt | integer | No | |
reporters[].notifiedAt | any | No | When the "this is fixed" message reached them. |
reporters[].images | object[] | No | The screenshots behind the report, each with somewhere to fetch it. Screenshots sent in the conversation are here alongside anything attached by link. |
reporters[].images[].url | string | No | |
reporters[].images[].name | string | No | |
reporters[].images[].external | boolean | No | True for an address Median does not serve. |
commits | object[] | No | |
commits[].id | string | No | |
commits[].sha | string | No | |
commits[].message | string | No | |
commits[].url | string | No | |
commits[].author | string | No | |
commits[].why | string | No | One line on why the reader thinks this is the one. |
commits[].applied | boolean | No |
Example request
curl https://api.median.sh/v1/signals/id \
-H "Authorization: Bearer $BEARER_AUTH"