Teams

List a team’s app inventory

User-gated (chrm_user_* or session); the caller must be an owner/admin of the team. Never includes a personal (user-owned) app, even one owned by a team member.

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

Request

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

sort'updatedAt:desc' | 'updatedAt:asc' | 'name:asc' | 'name:desc'

Order of the whole inventory. Defaults to updatedAt:desc (most recently updated first); name sorts case-insensitively by display name. Ties break by id in the same direction. An unknown value is rejected, not ignored.

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.

Response

The team’s app inventory.

oktrue required
hasMoreboolean required

True when the team owns more apps than this page returned.

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.