---
title: "Identity + setup readiness + live activity for the swarm dashboard"
method: GET
path: "/status"
tags: ["Status"]
---

# Identity + setup readiness + live activity for the swarm dashboard

`GET /status`

Single source of truth consumed by the UI home page. Identity comes from SWARM_* envs; the 7 setup milestones each emit `unverified | configured | verified`; activity counts agents alive in the last 5 min and tasks created in the last 24h; agent_fs reports whether AGENT_FS_API_URL is set.

## Response `200`

Status payload

- object
  - `identity` object, required
    - `name` string, required
    - `logo_url` string, nullable, required
    - `brand_color` string, nullable, required
    - `is_cloud` boolean, required
    - `marketing_url` string, nullable, required
    - `hide_cloud_promo` boolean, required
    - `org_id` string, nullable, required
  - `setup` object[], required
    - `id` 'harness' | 'slack' | 'github' | 'linear' | 'jira' | 'workers' | 'first_task', required
    - `label` string, required
    - `state` 'unverified' | 'configured' | 'verified', required
    - `hint` string
    - `action_url` string
    - `provider` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp'
    - `providers` object[]
      - `provider` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp', required
      - `state` 'unverified' | 'configured' | 'verified', required
      - `workers` integer, required
  - `activity` object, required
    - `agents_online` integer, required
    - `leads_online` integer, required
    - `recent_tasks_count` integer, required
  - `agent_fs` object, required
    - `configured` boolean, required
    - `base_url` string, nullable, required
    - `provider_id` string, required
    - `capabilities` object, required
  - `health` 'ok' | 'degraded' | 'broken', required

## Other responses

- `401` — Unauthorized

## Changes

- **2026-09-03** `0f5503f5cd28` — 2 warning
  - added the new `acp` enum value to the `setup/items/provider` response property for the response status `200`
  - added the new `acp` enum value to the `setup/items/providers/items/provider` response property for the response status `200`
- **2026-08-07** `06cac6a7c5bc` — 1 info
  - added the media type `application/json` for the response with the status `401`
- **2026-07-02** `5ed7f876c9c4` — 2 info
  - added the required property `agent_fs/capabilities` to the response with the `200` status
  - added the required property `agent_fs/provider_id` to the response with the `200` status
- **2026-07-02** `0c910612f9ac` — 2 breaking
  - removed the required property `agent_fs/capabilities` from the response with the `200` status
  - removed the required property `agent_fs/provider_id` from the response with the `200` status

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/status/get.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-service-production.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/revisions/e0acd2155cad/schema)