---
title: "List a team’s app inventory"
method: GET
path: "/api/v1/teams/{teamId}/apps"
tags: ["Teams"]
---

# List a team’s app inventory

`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`

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.

## Path parameters

- `teamId` string, required

## Query parameters

- `limit` integer
- `sort` 'updatedAt:desc' | 'updatedAt:asc' | 'name:asc' | 'name:desc'
- `cursor` string

## Response `200`

The team’s app inventory.

- TeamAppListResponse
  - `ok` true, required
  - `apps` TeamAppSummary[], required
    - `id` string, uuid, required
    - `appName` string, nullable, required: Friendly-URL slug.
    - `displayName` string, required
    - `visibility` 'public' | 'signed-in' | 'template' | 'shared' | 'private', required: The widest audience that can reach the app.
    - `createdByLabel` string, nullable, required: Display name of the account that created the app, null when no creator was recorded, and "Former member" when the creator has left the team or deleted their account.
    - `shareCount` integer, required: Share grants (accepted and pending) plus pending email invitations.
    - `updatedAtMs` integer, required
  - `hasMore` boolean, required: True when the team owns more apps than this page returned.
  - `nextCursor` string, nullable, required: Pass back as `cursor`, with the same `sort`, for the next page. Null on the last page.

## Other responses

- `400`: Invalid `limit`, `sort`, or `cursor`.
- `401`: Sign-in required.
- `403`: The caller is not an owner/admin of this team.

---

[API](https://skmtc.dev/charm/apis/charming-api.md) · [All operations](https://skmtc.dev/charm/apis/charming-api/llms.txt) · [OpenAPI document](https://skmtc.dev/charm/apis/charming-api/revisions/a9d06c419b3a?raw)