---
title: "List apps"
method: GET
path: "/client/apps"
tags: ["Apps"]
---

# List apps

`GET /client/apps`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/apps`
- Auth: HTTP bearer

Hosted apps with their live URL and status. Requires `apps:read`.

## Response `200`

Apps

- AppList
  - `data` AppListItem[], required
    - `id` string, uuid, required
    - `clientId` string, uuid, required
    - `groupId` string, uuid, nullable, required: The project this app is filed under, if any
    - `name` string, required
    - `status` string, required
    - `region` string, nullable: The app's home cell — the region chosen at create time, not its current placement
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `url` string, nullable, required: The app's address, once a deploy has been confirmed serving on it
    - `lastDeploy` object, nullable, required
      - `status` string, required
      - `error` string, nullable, required
      - `createdAt` string, date-time, required
    - `lastDeployedAt` string, date-time, nullable, required: Null until the first successful deploy
    - `serviceStatus` string, nullable: The web service's status (creating|building|deploying|live|crashed|stopped); null when the app has no web service
    - `permissions` ProjectPermissions, required
      - `role` 'viewer' | 'developer' | 'manager', nullable, required
      - `canCreateKey` boolean, required
      - `canDeploy` boolean, required
      - `canListSecrets` boolean, required
      - `canWriteSecrets` boolean, required
      - `canManageSecrets` boolean, required
      - `canManageMembers` boolean, required
      - `canViewContent` boolean, required
      - `canQueryData` boolean, required
      - `canWriteData` boolean, required
      - `canRestoreData` boolean, required
      - `canSetBudget` boolean, required

## Other responses

- `403`: Key lacks apps:read

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)