Skip to main content
GET
/
api
/
v1
/
apps
List apps
curl --request GET \
  --url https://cloud-api.phala.com/api/v1/apps
{
  "dstack_apps": [
    {
      "id": "<string>",
      "name": "<string>",
      "app_id": "<string>",
      "created_at": "<string>",
      "kms_type": "<string>",
      "app_provision_type": "<string>",
      "app_icon_url": "<string>",
      "profile": {
        "display_name": "<string>",
        "avatar_url": "<string>",
        "description": "<string>",
        "custom_domain": "<string>"
      },
      "current_cvm": {
        "vm_uuid": "<string>",
        "app_id": "<string>",
        "status": "<string>",
        "vcpu": 123,
        "memory": 123,
        "disk_size": 123,
        "teepod_id": 123,
        "teepod_name": "<string>",
        "region_identifier": "<string>",
        "kms_type": "<string>",
        "instance_type": "<string>",
        "name": "",
        "listed": true,
        "base_image": "<string>",
        "kms_slug": "<string>",
        "kms_id": "<string>",
        "instance_id": "<string>",
        "machine_info": {
          "vcpu": 123,
          "memory": 123,
          "disk_size": 123,
          "gpu_count": 123
        },
        "updated_at": "2023-11-07T05:31:56Z"
      },
      "cvms": [
        {
          "vm_uuid": "<string>",
          "app_id": "<string>",
          "status": "<string>",
          "vcpu": 123,
          "memory": 123,
          "disk_size": 123,
          "teepod_id": 123,
          "teepod_name": "<string>",
          "region_identifier": "<string>",
          "kms_type": "<string>",
          "instance_type": "<string>",
          "name": "",
          "listed": true,
          "base_image": "<string>",
          "kms_slug": "<string>",
          "kms_id": "<string>",
          "instance_id": "<string>",
          "machine_info": {
            "vcpu": 123,
            "memory": 123,
            "disk_size": 123,
            "gpu_count": 123
          },
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ],
      "cvm_count": 0,
      "team_slug": "<string>",
      "team_name": "<string>"
    }
  ],
  "page": 123,
  "page_size": 123,
  "total": 123,
  "total_pages": 123
}

Query Parameters

​
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
​
page_size
integer
default:20

Items per page

Required range: 1 <= x <= 100
​
search
string | null

Search name, app_id, vm_uuid, instance_id

​
status
string[] | null

CVM status filter

​
listed
boolean | null

Listed status filter

​
base_image
string | null

OS image name filter

​
instance_type
string | null

Instance type filter

​
kms_slug
string | null

KMS slug filter

​
kms_type
string | null

KMS type filter

​
node
string | null

Node name filter (matches teepod or node name)

​
region
string | null

Region identifier filter

Response

Paginated app list

​
dstack_apps
(DstackAppFullResponse · object | DstackAppMinimalResponse · object)[]
required
​
page
integer
required
​
page_size
integer
required
​
total
integer
required
​
total_pages
integer
required