---
title: "List your owned and shared apps, newest first"
method: GET
path: "/app"
---

# List your owned and shared apps, newest first

`GET /app`

## Request

- Base URL: `https://charm.ing`
- URL: `https://charm.ing/app`
- Auth: HTTP bearer

Paginated newest-first listing of apps the caller owns or has been granted access to. Use `cursor` (from the previous page) and `limit` to iterate. Each row carries its server revision, the `role` (owner | collaborator | end-user | viewer | team-admin | team-member), and a UUID-form `url` that redirects to the friendly owner-canonical URL.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Page of apps

- AppListResponse
  - `apps` object[], required
    - `id` string, uuid
    - `role` 'owner' | 'collaborator' | 'end-user' | 'viewer' | 'team-admin' | 'team-member': `owner` = your app. `collaborator` = shared with you via an accepted invite (edit and run, never share/delete/transfer). `end-user` = shared use-and-write-data (run the app and write its data, but cannot edit the app source). `viewer` = shared read-only. `team-admin` / `team-member` = owned by a team you belong to. Non-owner rows carry the UUID-form `url`, which redirects to the owner-canonical URL.
    - `manifestId` string
    - `displayName` string
    - `revision` integer, required: Server-owned app source revision. New apps start at 1, each successful source write advances it once, and historical null counters project as 0. `If-Match: "<N>"` and `expected_revision` carry this revision through its canonical concurrency grammar.
    - `capabilities` Capabilities (unresolved $ref)
    - `url` string, uri
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `nextCursor` string, nullable: Pass back as `cursor` query param to fetch the next page.

## Other responses

- `401`: Listing requires user-scoped auth (`chrm_user_*` or session).

---

[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)