Teams

List a team’s egress ledger (declared hosts and API ops)

User-gated (chrm_user_* or session); the caller must be an owner/admin of the team. outbound-host destinations are declared config with no call counts; api-op destinations are grouped api_proxy_result events with real counts.

get/api/v1/teams/{teamId}/egress

Request

  • Base URL: https://charm.ing
  • URL: https://charm.ing/api/v1/teams/{teamId}/egress
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Secure-better-auth.session_token

Path parameters

teamIdstring required

Query parameters

limitinteger

Defaults to 100, capped at 500.

appIdstring

Narrow to destinations the given app declares or calls.

sort'lastSeen:desc' | 'lastSeen:asc' | 'destination:asc' | 'destination:desc'

Order of the whole list before limit cuts it. Defaults to lastSeen:desc (most recently called first); an outbound-host destination has no lastSeenMs and sorts last either way. An unknown value is rejected, not ignored. CSV exports honour it too.

failedOnlyboolean

When true, keeps only api-op destinations with a 4xx/5xx or errored call — an all-200 op vanishes. Never hides outbound-host destinations.

range7 | 30 | 90

Restricts the api-op group to events within this many days.

format'csv'

When csv, returns text/csv instead of JSON, at a higher row cap. Any other value falls through to JSON.

Response

The team’s egress ledger, as JSON or (with format=csv) as text/csv.

oktrue required
hasMoreboolean required

True when the team has more destinations than this page returned.

scanTruncatedboolean required

True when the underlying event scan hit its row cap before grouping — every api-op destination’s calls/failedCalls in this response is a lower bound, not the true count.

Changes

No recorded changes to this operation across all 1 revision of this API.