Skip to content
SupaCloud Docs
Select themeSelect language

`GET /api/apps` -- list the workspace's Apps (without `manifest_yaml` so the payload stays small for long lists).

GET
/api/apps
curl --request GET \
  --url https://example.com/api/apps

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json
Array<object>

Lightweight list-row view – drops manifest_yaml so a workspace with dozens of large manifests does not balloon the list-API payload. The detail GET still returns the full AppView with the manifest.

#358 board: enriched with the per-card runtime state so the Apps list renders deploy status / version / route, the latest build, and the member counts without an extra round-trip. Every runtime field is nullable / defaulted so a never-deployed (draft) App lists cleanly. Serialised snake_case (the struct has no rename_all), matching the existing list fields and the App domain row.

object
created_at
required
string format: date-time
deploy_status

Active deployment status (deployed | paused | draft | undeployed). None ⇒ the App has never been deployed (draft).

string | null
deployed_version

Version string of the active deployment (e.g. 1.0.0). None when there is no deployment.

string | null
description
string | null
framework
required

ADR 0030 – build framework, so list cards can show a framework badge without fetching the full manifest.

string
id
required
string format: uuid
latest_build_at

Finished-at of the most-recent build (completed_at). None when the App has never been built OR the latest build is still running.

string | null format: date-time
latest_build_status

Status of the most-recent build (queued | claimed | building | succeeded | failed). None when the App has never been built.

string | null
name
required
string
resource_count
required

Number of resources wired into the App (membership join).

integer format: int64
route

Public route of the active deployment, /a/{workspace}/{route}. None when there is no deployment.

string | null
script_count
required

Number of scripts wired into the App (membership join).

integer format: int64
slug
required
string
updated_at
required
string format: date-time
workflow_count
required

Number of workflows wired into the App (membership join).

integer format: int64
workspace_id
required
string format: uuid
Examplegenerated
[
  {
    "created_at": "2026-04-15T12:00:00Z",
    "deploy_status": "example",
    "deployed_version": "example",
    "description": "example",
    "framework": "example",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "latest_build_at": "2026-04-15T12:00:00Z",
    "latest_build_status": "example",
    "name": "example",
    "resource_count": 1,
    "route": "example",
    "script_count": 1,
    "slug": "example",
    "updated_at": "2026-04-15T12:00:00Z",
    "workflow_count": 1,
    "workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
]