---
title: "Worker self-report of credential readiness (Phase 3 boot loop)"
method: PUT
path: "/api/agents/{id}/credential-status"
tags: ["Agents"]
---

# Worker self-report of credential readiness (Phase 3 boot loop)

`PUT /api/agents/{id}/credential-status`

## Path parameters

- `id` string, required

## Request body

- object
  - `ready` boolean
  - `missing` string[], nullable
  - `cred_status` object, nullable
    - `ready` boolean, required
    - `missing` string[]
    - `satisfiedBy` 'env' | 'file' | 'side-effect-pending' | 'sdk-delegated' | 'null', nullable
    - `hint` string, nullable
    - `liveTest` object, nullable
      - `ok` boolean, required
      - `error` string, nullable
      - `latency_ms` number, required
      - `testedAt` number, required
    - `latestModel` object, 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` object, nullable
      - `region` string, required
      - `probedAt` number, required
      - `ready` boolean, required
      - `models` object[]
        - `id` string, required
        - `name` string, required
      - `error` string
  - `latest_model` object
    - `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'

## Response `200`

State updated; returns the agent row.

## Other responses

- `404` — Agent not found

## Changes

- **2026-07-10** `5b7df66bb887` — 2 info
  - added the new `max` enum value to the request property `cred_status/latestModel/reasoningEffort`
  - added the new `max` enum value to the request property `latest_model/reasoningEffort`
- **2026-07-02** `0c910612f9ac` — 2 breaking
  - removed the enum value `max` of the request property `cred_status/latestModel/reasoningEffort`
  - removed the enum value `max` of the request property `latest_model/reasoningEffort`

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/agents/:id/credential-status/put.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/92a1dcbd2fc7?raw)