Agency RollupsPer-location destination health

Per-location destination health

Delivery health of every location's activation destinations over a trailing window — one row per (location, destination action) with success rate, failure counts, and the last error. Sorted worst-first (lowest success rate, most failures), so the top rows are which client's activation is bleeding. Test deliveries are excluded, and in-flight retries don't count toward totals.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/agency/destinations/health?location_ids=loc_abc123%2Cloc_def456&hours_back=24" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": {
    "hours_back": 24,
    "destinations": [
      {
        "location_id": "loc_abc123",
        "action_id": "meta-capi-purchase",
        "action_name": "Meta CAPI Purchase",
        "destination_type": "meta_capi",
        "total": 1180,
        "successes": 1102,
        "failures": 78,
        "success_rate": 0.9339,
        "last_delivery_at": "2024-12-25T10:00:00Z",
        "last_error": "401 Invalid OAuth access token"
      }
    ]
  }
}
GET
/client/v1/agency/destinations/health
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) only — a location secret key (sk_) gets 403 agency_required. Keys are server-side credentials; this surface serves no CORS headers on purpose. Agency-wide scoped keys (mcp_ with no fixed location) are accepted too and need agency:read; a client-bound mcp_ key gets 403 agency_key_required. See Using an mcp_ key over HTTP.

Agency key (ak_) only — a location secret key (sk_) gets 403 agency_required. Keys are server-side credentials; this surface serves no CORS headers on purpose. Agency-wide scoped keys (mcp_ with no fixed location) are accepted too and need agency:read; a client-bound mcp_ key gets 403 agency_key_required. See Using an mcp_ key over HTTP.
query
location_idsstring

Comma-separated location ids to narrow the roster. Every id must belong to this agency — a foreign id is 403 location_not_linked, never a silent empty result. Required in batches of up to 100 when the agency has more than 100 locations.

query
hours_backinteger

Trailing window in hours (1–720).

Min: 1 • Max: 720
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) only — a location secret key (sk_) gets 403 agency_required. Keys are server-side credentials; this surface serves no CORS headers on purpose. Agency-wide scoped keys (mcp_ with no fixed location) are accepted too and need agency:read; a client-bound mcp_ key gets 403 agency_key_required. See Using an mcp_ key over HTTP.

Query Parameters

location_idsstring

Comma-separated location ids to narrow the roster. Every id must belong to this agency — a foreign id is 403 location_not_linked, never a silent empty result. Required in batches of up to 100 when the agency has more than 100 locations.

Example:
loc_abc123,loc_def456
hours_backinteger

Trailing window in hours (1–720).

Responses

successboolean
dataobject