---
title: "The agents of THIS workspace and how each is doing. Plain counts; not a score, not a ranking (1.61.0)."
method: GET
path: "/agents"
---

# The agents of THIS workspace and how each is doing. Plain counts; not a score, not a ranking (1.61.0).

`GET /agents`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/agents`
- Auth: HTTP bearer

Only the credential's own workspace. Each agent: agent_id, name, credential_class (agent_identity | legacy_key; a legacy key bound to an identity is folded into that identity and listed in bound_legacy_key_ids), status, first_call, last_call, calls_7d, calls_30d, writes_30d, errors_30d, and track_record over the actions it CREATED in the window: created, with_expected_signal, executed, signal_recorded, outcome_expected, outcome_partial, outcome_other, closed_without_signal, overdue (expected_signal_at passed with no signal), split into overdue_unchecked, overdue_checked_not_found and overdue_cannot_check by the LATEST signal check (they sum to overdue). Each agent also carries invited_by when it joined through an invitation. coverage counts the window's actions by known creator and no_known_creator, so a zero is never read as "did nothing". Capability: actions:read.

## Query parameters

- `days` integer

## Response `200`

Agents

- object
  - `workspace_id` string
  - `window_days` integer
  - `since` string
  - `agent_count` integer
  - `agents` object[]
  - `coverage` object
    - `actions_in_window` integer
    - `created_by_agents` integer
    - `created_by_agents_not_listed` integer
    - `created_by_humans` integer
    - `no_known_creator` integer
  - `note` string

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)