---
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'
    - `providers` object[]
      - `provider` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode', 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

---

[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)