Agency RollupsTracking heartbeat across clients

Tracking heartbeat across clients

Events received and the latest event time for every client over a trailing window, in one call. The agency form of GET /client/v1/locations/last-event. Every client in the roster is returned: one with no events in the window has events 0 and last_event_at null, which usually means a missing snippet or no traffic.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/agency/last-event?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,
    "locations": [
      {
        "location_id": "example_string",
        "name": "Rockwell Supply",
        "events": 425,
        "last_event_at": "2026-10-06T00:42:02Z"
      }
    ]
  }
}
GET
/client/v1/agency/last-event
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

Lookback 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

Lookback window in hours (1–720).

Responses

successboolean
dataobject