---
title: "AgentEdgeAppInstanceList"
method: GET
path: "/agents/{agentId}/edge-app-instances"
tags: ["AgentEdgeAppInstanceList"]
---

# AgentEdgeAppInstanceList

`GET /agents/{agentId}/edge-app-instances`

## Path parameters

- `agentId` string, required

## Query parameters

- `fields` string[]
- `filters` string[]

## Headers

- `Api-Version` 2, required
- `Api-Application` string, required
- `Api-Company` string, required
- `Api-Branding` string

## Response `200`

Success response. Data could be an object instead of a list when one value is returned

- object
  - `status` string, required
  - `type` string, required
  - `moreAfter` string, nullable
  - `data` object[], required
    - `publicId` string
    - `agent` object
      - `publicId` string
    - `edgeAppVersion` object
      - `publicId` string
    - `status` 'error' | 'deploying' | 'pending' | 'running' | 'deleting'
    - `progress` unknown
    - `differentConfigs` boolean
    - `lastEvent` string, date-time, nullable
    - `name` string
    - `services` object[]
      - `publicId` string
      - `agent` object
        - `publicId` string
      - `instance` object
        - `publicId` string
      - `name` string
      - `overrides` object
        - `environment` string, nullable
        - `ports` object[]
          - `sourcePort` string
          - `protocol` 'udp' | 'tcp' | 'both'
          - `targetPort` string
          - `service` object
            - `publicId` string
    - `files` object[]
      - `publicId` string
      - `path` string
      - `edgeAppVersion` object, nullable
        - `publicId` string
      - `agentEdgeAppInstance` object, nullable
        - `publicId` string

## Other responses

- `4XX` — 4XX error response

---

[API](https://skmtc.net/ixon/apis/ixon-api.md) · [All operations](https://skmtc.net/ixon/apis/ixon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ixon/ixon-api/revisions/7875dc33d41f/schema)