v1
latestOpenAPI 3.1.02026-07-26102158206.8 KBApps
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
Example response
{
"dstack_apps": [
{
"id": "prj_0123abcd"
}
]
}