v1

latestOpenAPI 3.1.02026-07-26102158206.8 KB
Apps

List apps

Returns paginated app list with filtering. Response schema varies by API version.

get/api/v1/apps

Query parameters

pageinteger

Page number (1-indexed)

Page number (1-indexed)

page_sizeinteger

Items per page

Items per page

searchstring nullable

Search name, app_id, vm_uuid, instance_id

Search name, app_id, vm_uuid, instance_id

statusstring[] nullable

CVM status filter

CVM status filter

listedboolean nullable

Listed status filter

Listed status filter

base_imagestring nullable

OS image name filter

OS image name filter

instance_typestring nullable

Instance type filter

Instance type filter

kms_slugstring nullable

KMS slug filter

KMS slug filter

kms_typestring nullable

KMS type filter

KMS type filter

nodestring nullable

Node name filter (matches teepod or node name)

Node name filter (matches teepod or node name)

regionstring nullable

Region identifier filter

Region identifier filter

Response

Paginated app list

OR

Example response

{
  "dstack_apps": [
    {
      "id": "prj_0123abcd"
    }
  ]
}