Repo delivery health across user projects — getintegrationwebhooksstatus

GET

/integrations/webhooks/status

const url = 'https://example.com/api/integrations/webhooks/status';
const options = {method: 'GET', headers: {cookie: 'sb-access-token=<sb-access-token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/integrations/webhooks/status \
  --cookie sb-access-token=<sb-access-token>

Delivery health of every repo linked to the caller’s projects (project_repos), derived from GitHub App coverage and the deliveries the receiver saw — no repository hook is inspected. Coverage answers from the stored installation row when the owner’s installation is on all repos; for an installation on selected repos (or one with no stored login yet) it asks GitHub which installation covers the repo (cached in process). Each repo carries a state: delivering (the GitHub App covers it and a delivery arrived inside the freshness window), quiet (covered, nothing lately — healthy), not_covered (no installation of the project’s account reaches the repo; owner is who must install the App), or unknown (coverage could not be determined right now, never read as not covered). Delivery evidence (last_delivery_at, last_event, delivery_count) is returned only for covered repos. A repo linked by several projects reads as its best coverage. healthy counts delivering and quiet repos. Repos are keyed by canonical lowercase owner/repo.

Authorizations

cookieAuth

Parameters

Query Parameters

project_id

string format: uuid

Responses

200

Status map

application/json

object

repos

required

Repo status entries keyed by canonical lowercase owner/repo.

object

key

additional properties

object

repo

required

Canonical lowercase owner/repo.

string

state

required

string

Allowed values: delivering quiet not_covered unknown

owner

required

GitHub owner login of the repo — who must install the App when not covered.

string

last_delivery_at

required

string | null format: date-time

last_event

required

string | null

delivery_count

required

integer

total

required

integer

healthy

required

Repos that are delivering or quiet (nothing pending).

integer

delivering

required

Repos with an inbound delivery observed inside the freshness window.

integer

400

Invalid query parameters

401

Not authenticated

application/json

object

error

required

Human-readable error message

string

code

Stable machine-readable error code for client branching

string

fieldErrors

First validation message per field path

object

key

additional properties

string

issues

Structured validation issues (Zod)

Array<object>

object

path

required

string

message

required

string

retryAfter

Seconds until rate limit resets (429 responses)

number

reconnect

True if re-linking GitHub may fix the issue

boolean

500

Failed to load projects