List webhooks

Every endpoint, and whether each is answering.

GET/webhooks

Authorization

AuthorizationBearer token · headerrequired

`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.

Responses

200The endpoints.

webhooksWebhookEndpoint[]

Show properties

Array of WebhookEndpoint

idstring

urlstring

eventsWebhookEvent[]

createdAtinteger

lastDeliveryAtinteger | null

failingSinceinteger | null

401The bearer token is missing, revoked, or expired.

errorobject

Show properties

codestring

messagestring

403The token's person does not hold the role this needs.

errorobject

Show properties

codestring

messagestring

429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).

errorobject

Show properties

codestring

messagestring

Request

curl -X GET "https://api.median.sh/v1/webhooks" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/webhooks", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "webhooks": [
    {
      "id": "string",
      "url": "string",
      "events": [
        "message.created"
      ],
      "createdAt": 0,
      "lastDeliveryAt": 0,
      "failingSince": 0
    }
  ]
}