---
title: "Get app details"
method: GET
path: "/api/v1/apps/{app_id}"
tags: ["Apps"]
---

# Get app details

`GET /api/v1/apps/{app_id}`

Returns app metadata and current CVM configuration. Response schema varies by API version.

## Path parameters

- `app_id` string, required — Hex app identifier

## Response `200`

App details with CVM info

- union
  - TeehouseApiRoutesAppsV20251028SchemasDstackAppFullResponse
    - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
    - `name` string, required
    - `app_id` string, required
    - `app_provision_type` string, nullable
    - `app_icon_url` string, nullable
    - `created_at` string, required
    - `kms_type` string, required
    - `profile` ProfileGetResponse — Response model for entity profile - only public display data.
      - `display_name` string, nullable
      - `avatar_url` string, nullable
      - `description` string, nullable
      - `custom_domain` string, nullable
    - `current_cvm` TeehouseApiRoutesAppsV20251028SchemasCvmBasicInfo
      - `vm_uuid` string, nullable, required
      - `app_id` string, required
      - `name` string
      - `status` string, required
      - `vcpu` integer, required
      - `memory` integer, required
      - `disk_size` integer, required
      - `teepod_id` integer, required
      - `teepod_name` string, required
      - `region_identifier` string, nullable, required
      - `kms_type` string, nullable, required
      - `instance_type` string, nullable, required
      - `listed` boolean, nullable
      - `base_image` string, nullable
      - `kms_slug` string, nullable
      - `kms_id` string, nullable
      - `instance_id` string, nullable
      - `machine_info` MachineInfo — CVM hardware configuration.
        - `vcpu` integer, required — Virtual CPU count
        - `memory` integer, required — Memory in MB
        - `disk_size` integer, required — Disk size in GB
        - `gpu_count` integer, required — GPU count (0 if none)
      - `updated_at` string, date-time, nullable
    - `cvms` TeehouseApiRoutesAppsV20251028SchemasCvmBasicInfo[]
      - `vm_uuid` string, nullable, required
      - `app_id` string, required
      - `name` string
      - `status` string, required
      - `vcpu` integer, required
      - `memory` integer, required
      - `disk_size` integer, required
      - `teepod_id` integer, required
      - `teepod_name` string, required
      - `region_identifier` string, nullable, required
      - `kms_type` string, nullable, required
      - `instance_type` string, nullable, required
      - `listed` boolean, nullable
      - `base_image` string, nullable
      - `kms_slug` string, nullable
      - `kms_id` string, nullable
      - `instance_id` string, nullable
      - `machine_info` MachineInfo — CVM hardware configuration.
        - `vcpu` integer, required — Virtual CPU count
        - `memory` integer, required — Memory in MB
        - `disk_size` integer, required — Disk size in GB
        - `gpu_count` integer, required — GPU count (0 if none)
      - `updated_at` string, date-time, nullable
    - `cvm_count` integer
    - `team_slug` string, nullable
    - `team_name` string, nullable
  - DstackAppMinimalResponse
    - `id` unknown
    - `app_id` string, required
    - `name` unknown
    - `app_provision_type` unknown
    - `app_icon_url` unknown
    - `created_at` unknown
    - `kms_type` unknown
    - `profile` unknown
    - `current_cvm` unknown
    - `cvms` unknown
    - `cvm_count` unknown
  - TeehouseApiRoutesAppsV20260121SchemasDstackAppFullResponse
    - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
    - `name` string, required
    - `app_id` string, required
    - `app_provision_type` string, nullable
    - `app_icon_url` string, nullable
    - `created_at` string, required
    - `kms_type` string, required
    - `profile` ProfileGetResponse — Response model for entity profile - only public display data.
      - `display_name` string, nullable
      - `avatar_url` string, nullable
      - `description` string, nullable
      - `custom_domain` string, nullable
    - `current_cvm` TeehouseApiRoutesCvmsV20260121SchemasCVMInfo
      - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
      - `name` string, required
      - `app_id` string, nullable
      - `vm_uuid` string, nullable
      - `instance_id` string, nullable
      - `resource` CVMResourceInfo, required
        - `instance_type` string, nullable
        - `vcpu` integer, nullable
        - `memory_in_gb` number, nullable
        - `disk_in_gb` integer, nullable
        - `gpus` integer, nullable
        - `compute_billing_price` string, decimal, nullable — A monetary value with precise decimal arithmetic
        - `billing_period` 'skip' | 'hourly' | 'monthly'
      - `node_info` NodeRef — Minimal node/teepod reference for embedding in responses.
        - `object_type` 'node' — Fixed value 'node'
        - `id` integer, nullable — Teepod numeric ID
        - `node_id` integer, nullable — Physical node numeric ID
        - `name` string, nullable — Node display name
        - `region` string, nullable — Region identifier
        - `device_id` string, nullable — Device ID
        - `ppid` string, nullable — PPID
        - `status` 'ONLINE' | 'OFFLINE' | 'MAINTENANCE'
        - `version` string, nullable — Teepod version
      - `os` CVMOSInfo
        - `name` string, nullable
        - `version` string, nullable
        - `is_dev` boolean, nullable
        - `os_image_hash` string, nullable
      - `kms_type` 'phala' | 'ethereum' | 'base' | 'legacy'
      - `kms_info` CVMKmsInfo
        - `chain_id` integer, nullable
        - `dstack_kms_address` string, nullable
        - `dstack_app_address` string, nullable
        - `deployer_address` string, nullable
        - `rpc_endpoint` string, nullable
        - `encrypted_env_pubkey` string, nullable
      - `status` string, required
      - `in_progress` boolean
      - `progress` CVMProgressInfo
        - `target` string, nullable
        - `started_at` string, date-time, nullable
        - `correlation_id` string, nullable
      - `compose_hash` string, nullable
      - `docker_compose_hash` string, nullable
      - `pre_launch_script_hash` string, nullable
      - `gateway` CVMGatewayInfo, required
        - `base_domain` string, nullable
        - `cname` string, nullable
      - `logs` CVMLogUrls
        - `serial` string, nullable
        - `stdout` string, nullable
        - `stderr` string, nullable
        - `container_log_base` string, nullable
      - `services` object[]
      - `endpoints` CvmNetworkUrls[], nullable
        - `app` string, required
        - `instance` string, required
      - `public_logs` boolean
      - `public_sysinfo` boolean
      - `public_tcbinfo` boolean
      - `gateway_enabled` boolean
      - `secure_time` boolean
      - `storage_fs` string
      - `workspace` WorkspaceRef — Minimal workspace reference for embedding in responses.
        - `object_type` 'workspace' — Fixed value 'workspace'
        - `id` string, hashid, required — Hashed workspace ID
        - `name` string, required — Workspace display name
        - `slug` string, nullable — URL-safe workspace identifier
        - `avatar_url` string, nullable — Workspace avatar URL from profile
      - `creator` UserRef — Minimal user reference for embedding in responses.
        - `object_type` 'user' — Fixed value 'user'
        - `id` string, hashid, nullable — A hashed identifier that maps to an internal database ID
        - `username` string, nullable — Display username
        - `avatar_url` string, nullable — Gravatar or OAuth provider avatar URL
      - `created_at` string, date-time, nullable
      - `deleted_at` string, date-time, nullable
      - `listed` boolean
      - `project_type` string, nullable
    - `cvms` TeehouseApiRoutesCvmsV20260121SchemasCVMInfo[]
      - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
      - `name` string, required
      - `app_id` string, nullable
      - `vm_uuid` string, nullable
      - `instance_id` string, nullable
      - `resource` CVMResourceInfo, required
        - `instance_type` string, nullable
        - `vcpu` integer, nullable
        - `memory_in_gb` number, nullable
        - `disk_in_gb` integer, nullable
        - `gpus` integer, nullable
        - `compute_billing_price` string, decimal, nullable — A monetary value with precise decimal arithmetic
        - `billing_period` 'skip' | 'hourly' | 'monthly'
      - `node_info` NodeRef — Minimal node/teepod reference for embedding in responses.
        - `object_type` 'node' — Fixed value 'node'
        - `id` integer, nullable — Teepod numeric ID
        - `node_id` integer, nullable — Physical node numeric ID
        - `name` string, nullable — Node display name
        - `region` string, nullable — Region identifier
        - `device_id` string, nullable — Device ID
        - `ppid` string, nullable — PPID
        - `status` 'ONLINE' | 'OFFLINE' | 'MAINTENANCE'
        - `version` string, nullable — Teepod version
      - `os` CVMOSInfo
        - `name` string, nullable
        - `version` string, nullable
        - `is_dev` boolean, nullable
        - `os_image_hash` string, nullable
      - `kms_type` 'phala' | 'ethereum' | 'base' | 'legacy'
      - `kms_info` CVMKmsInfo
        - `chain_id` integer, nullable
        - `dstack_kms_address` string, nullable
        - `dstack_app_address` string, nullable
        - `deployer_address` string, nullable
        - `rpc_endpoint` string, nullable
        - `encrypted_env_pubkey` string, nullable
      - `status` string, required
      - `in_progress` boolean
      - `progress` CVMProgressInfo
        - `target` string, nullable
        - `started_at` string, date-time, nullable
        - `correlation_id` string, nullable
      - `compose_hash` string, nullable
      - `docker_compose_hash` string, nullable
      - `pre_launch_script_hash` string, nullable
      - `gateway` CVMGatewayInfo, required
        - `base_domain` string, nullable
        - `cname` string, nullable
      - `logs` CVMLogUrls
        - `serial` string, nullable
        - `stdout` string, nullable
        - `stderr` string, nullable
        - `container_log_base` string, nullable
      - `services` object[]
      - `endpoints` CvmNetworkUrls[], nullable
        - `app` string, required
        - `instance` string, required
      - `public_logs` boolean
      - `public_sysinfo` boolean
      - `public_tcbinfo` boolean
      - `gateway_enabled` boolean
      - `secure_time` boolean
      - `storage_fs` string
      - `workspace` WorkspaceRef — Minimal workspace reference for embedding in responses.
        - `object_type` 'workspace' — Fixed value 'workspace'
        - `id` string, hashid, required — Hashed workspace ID
        - `name` string, required — Workspace display name
        - `slug` string, nullable — URL-safe workspace identifier
        - `avatar_url` string, nullable — Workspace avatar URL from profile
      - `creator` UserRef — Minimal user reference for embedding in responses.
        - `object_type` 'user' — Fixed value 'user'
        - `id` string, hashid, nullable — A hashed identifier that maps to an internal database ID
        - `username` string, nullable — Display username
        - `avatar_url` string, nullable — Gravatar or OAuth provider avatar URL
      - `created_at` string, date-time, nullable
      - `deleted_at` string, date-time, nullable
      - `listed` boolean
      - `project_type` string, nullable
    - `cvm_count` integer
  - DstackAppMinimalResponse
    - `id` unknown
    - `app_id` string, required
    - `name` unknown
    - `app_provision_type` unknown
    - `app_icon_url` unknown
    - `created_at` unknown
    - `kms_type` unknown
    - `profile` unknown
    - `current_cvm` unknown
    - `cvms` unknown
    - `cvm_count` unknown

## Other responses

- `401` — Not authenticated
- `403` — No workspace access
- `404` — App not found
- `422` — Validation Error

---

[API](https://skmtc.net/phala/apis/phala-cloud-api.md) · [All operations](https://skmtc.net/phala/apis/phala-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phala/phala-cloud-api/versions/83c6ae62e860/schema)