StatusDashboard
Google ChatSuppression

List Google Chat suppressions

Retrieve the organization's outbound Google Chat suppression list.

View Markdown

GET /app/integrations/gchat/suppression

Returns a paginated list of suppressed Google Chat endpoints for the organization. Entries are created after repeated delivery failures (or manually).

Requires the admin or subscriber role and the integrations feature entitlement.


Request

See API Basics for required headers.

Query parameters

ParameterTypeRequiredDescription
limitintegerNoMax entries per page. Range: 1–100. Default: 10.
nextTokenstringNoNext-page bookmark from the previous response — pass unchanged. See Pagination.
urlHashstringNoFilter to one endpoint hash.

Sample request

curl "https://api.statusdashboard.com/app/integrations/gchat/suppression" \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Sample response

Status: 200 OK

{
  "suppressions": [
    {
      "channel": "gchat",
      "urlHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "urlDisplay": "chat.googleapis.com/v1?…",
      "reason": "delivery_failures",
      "detail": "5 consecutive failures",
      "consecutiveFailures": 5,
      "suppressedAt": "2026-06-26T14:30:00.000Z",
      "lastEventAt": "2026-06-26T14:30:00.000Z",
      "managementEmail": "ops@acme.com",
      "dashboardId": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "nextToken": null
}

Response fields

FieldTypeDescription
suppressionsarraySuppression entries for this page.
nextTokenstring | nullNext-page bookmark when more results exist. See Pagination.

Entry fields

Each suppressions[] item:

FieldTypeDescription
channelstringgchat
urlHashstringEndpoint hash.
urlDisplaystring | omittedRedacted endpoint display when the identity still exists.
reasonstringdelivery_failures or manual.
detailstring | omittedHuman-readable summary when available.
consecutiveFailuresnumber | omittedFailure count at suppress time.
suppressedAtstringISO 8601 — first time this endpoint was suppressed.
lastEventAtstringISO 8601 — most recent event for this entry.
managementEmailstring | omittedManagement contact when recorded.
dashboardIdstring | omittedDashboard UUID when recorded.

Pagination

See Pagination in API Basics. Re-send the same query parameters on every page request.


Retention

Suppression entries do not expire. They remain until removed via DELETE suppression.


Error responses

StatusWhen
400Invalid query parameters.
403Insufficient role, or integrations not enabled on your plan.

On this page

We use cookies

We use essential cookies to keep the site working, and optional analytics cookies to understand how it's used. Read our Privacy Policy.