Teams

List a team’s people

User-gated (chrm_user_* or session); the caller must be an owner/admin of the team. Every CURRENT team member with role, apps owned, apps created, last activity, and external shares granted.

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

Request

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

Path parameters

teamIdstring required

Query parameters

limitinteger

Defaults to 500, the cap, so one response carries the whole roster of all but the largest teams.

qstring

Case-insensitive match against the member label (name, handle, or email).

sort'label:asc' | 'label:desc' | 'role:asc' | 'role:desc' | 'appsOwned:asc' | 'appsOwned:desc' | 'appsCreated:asc' | 'appsCreated:desc' | 'lastActive:asc' | 'lastActive:desc' | 'externalShares:asc' | 'externalShares:desc'

Order of the whole roster before limit cuts it. Defaults to label:asc. Ties fall to the member label, then the user id, ascending; a member with no recorded activity sorts as the earliest lastActive. An unknown value is rejected, not ignored. CSV exports honour it, and q, too.

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

oktrue required
hasMoreboolean required

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

Changes

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