v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Apps

Retrieve App Instances

Retrieve the list of running instances for a given application, including instance names and component types. Please note that these instances are ephemeral and may change over time. It is recommended not to make persistent changes or develop scripts that rely on their persistence.

get/v2/apps/{app_id}/instances

Path parameters

app_idstring required

The app ID

Response

A JSON with key instances

Example response

{
  "instances": [
    {
      "component_name": "sample-golang",
      "component_type": "SERVICE",
      "instance_name": "sample-golang-76b84c7fb8-6p8kq",
      "instance_alias": "sample-golang-0"
    }
  ]
}