Other endpoints

Health and machine-readable surfaces that are not OAuth or bot status.

Webhook gateway health

GET https://api.meridian.surf/health

No auth. Use this for uptime monitors that care about inbound webhook delivery.

Healthy

200:

{
  "status": "ok",
  "service": "webhooks",
  "backend": { "latencyMs": 12 },
  "timestamp": "2026-08-09T18:00:00.000Z"
}

Unavailable

503:

{
  "status": "unavailable",
  "service": "webhooks",
  "reason": "gateway_not_configured"
}

reason may also be backend_not_ready or backend_error.

OpenAPI specification

GET https://api.meridian.surf/openapi.json

OpenAPI 3.1 for the OAuth endpoints (consent, token, userinfo, revoke). See OpenAPI for import notes. Bot status and webhooks are documented in prose on this site and are not in that spec yet.

Bot HTTP webhooks
Bot status API
OAuth quickstart

Overview

OAuth API

Bot status API

Other API endpoints

Webhook gateway health

Healthy

Unavailable

OpenAPI specification

​Webhook gateway health

​Healthy

​Unavailable

​OpenAPI specification

​Related

Webhook gateway health

Healthy

Unavailable

OpenAPI specification

Related