---
title: "Bulk credential-status across all agents (powers the dashboard)"
method: GET
path: "/api/agents/credential-status"
tags: ["Agents"]
---

# Bulk credential-status across all agents (powers the dashboard)

`GET /api/agents/credential-status`

## Query parameters

- `status` 'idle' | 'busy' | 'offline' | 'waiting_for_credentials'

## Response `200`

List of {agentId, status, missing[], lastCheckedAt}

- object
  - `agents` object[], required
    - `agentId` string, required
    - `name` string, required
    - `status` 'idle' | 'busy' | 'offline' | 'waiting_for_credentials', required
    - `missing` string[], required
    - `provider` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'null', nullable, required
    - `harnessProvider` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'null', nullable, required
    - `credStatus` AgentCredStatus, required
      - `ready` boolean, required
      - `missing` string[]
      - `satisfiedBy` 'env' | 'file' | 'side-effect-pending' | 'sdk-delegated' | 'null', nullable
      - `hint` string, nullable
      - `liveTest` AgentCredStatusLiveTest, nullable
        - `ok` boolean, required
        - `error` string, nullable
        - `latency_ms` number, required
        - `testedAt` number, required
      - `latestModel` AgentLatestModel, nullable
        - `model` string, required
        - `source` 'task' | 'agent_config' | 'adapter_default' | 'custom', required
        - `taskId` string, nullable
        - `harnessProvider` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'null', nullable
        - `reportedAt` number, required
        - `reasoningEffort` 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'
      - `reportedAt` number, required
      - `reportKind` 'boot' | 'post_task'
      - `bedrock` AgentBedrockStatus, nullable
        - `region` string, required
        - `probedAt` number, required
        - `ready` boolean, required
        - `models` object[]
          - `id` string, required
          - `name` string, required
        - `error` string
    - `lastCheckedAt` string, required

---

[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/versions/ef761849166b/schema)