---
title: "List runtime instances serving an agent"
method: GET
path: "/api/agents/{id}/runtime-instances"
tags: ["Agents"]
---

# List runtime instances serving an agent

`GET /api/agents/{id}/runtime-instances`

Read-only view of the worker processes currently registered for a logical agent. Rows exist only for multi-runtime registrations (MULTI_RUNTIME_ENABLED), so the list is empty in the default configuration. `isLive` combines `status` with `lastSeenAt` freshness against the server's staleness cutoff (`staleThresholdMinutes`); `reportedSlots` is each process's self-reported capacity, distinct from the agent's logical `maxTasks` policy.

## Path parameters

- `id` string, required

## Response `200`

Runtime instances for the agent (empty when none are registered)

- object
  - `runtimeInstances` object[], required
    - `id` string, required
    - `agentId` string, required
    - `status` 'active' | 'offline', required
    - `reportedSlots` integer, required
    - `credentialReady` boolean, nullable
    - `lastSeenAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `isLive` boolean, required
  - `staleThresholdMinutes` integer, required

## Other responses

- `404` — Agent not found

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/revisions/d06bca6c3ff5/schema)