Teams

Get a team’s audit trail

User-gated (chrm_user_* or session); the caller must be an owner/admin of the team. Newest-first (unless sort says otherwise) feed of share/publish lifecycle events AND end-user activity (renders, API calls) for every app the team owns. Defaults to the trailing 7 days.

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

Request

  • Base URL: https://charm.ing
  • URL: https://charm.ing/api/v1/teams/{teamId}/audit
  • 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 uuid

Narrows to one app.

actorstring

A user id — narrows to events where that person is the actor OR the end-user viewer.

kindstring

Narrows to one event kind. An unrecognized kind is rejected, not ignored.

range7 | 30 | 90

Trailing days to include. Defaults to 7.

sort'createdAt:desc' | 'createdAt:asc'

Order of the whole trail. Defaults to createdAt:desc (newest first); ties break by id in the same direction. An unknown value is rejected, not ignored. CSV exports honour it too.

cursorstring

The load-more cursor: the nextCursor of the previous page, sent with the same sort. A cursor from a different sort, or one that does not decode, is rejected with a 400. CSV exports ignore it.

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 audit trail, as JSON or (with format=csv) as text/csv.

oktrue required
hasMoreboolean required

True when more rows follow this page under the active sort.

nextCursorstring nullable required

Pass back as cursor, with the same sort, for the next page. Null on the last page.

Changes

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