---
title: "Lister le roster opérationnel des Agents"
method: GET
path: "/api/v1/agents/workforce"
tags: ["Agents", "AI Workforce"]
---

# Lister le roster opérationnel des Agents

`GET /api/v1/agents/workforce`

## Request

- Base URL: `https://arcadeops.leadalpes.fr`
- URL: `https://arcadeops.leadalpes.fr/api/v1/agents/workforce`
- Auth: none declared

Sépare le statut de configuration de la présence dérivée et expose une situation sourcée, la Mission courante, la charge et l’action contextuelle.

## Query parameters

- `limit` integer
- `cursor` string
- `agentId` string
- `q` string
- `status` 'ENABLED' | 'DISABLED' | 'EPHEMERAL'
- `type` 'CEO' | 'MANAGER' | 'SPECIALIST' | 'META' | 'SERVICE'

## Response `200`

Roster tenanté avec présence et responsabilités bornées

- AgentWorkforceList
  - `items` object[], required
    - `id` string, required
    - `orgId` string, required
    - `handle` string, required
    - `name` string, required
    - `type` string, required
    - `configurationStatus` string, required
    - `status` string, required: Alias de compatibilité ; utiliser configurationStatus.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `lastActivityAt` string, date-time, nullable, required
    - `workState` 'AVAILABLE' | 'THINKING' | 'QUEUED' | 'WORKING' | 'RESPONSE_REQUIRED' | 'BLOCKED' | 'OFFLINE', required
    - `workStateLabel` string, required
    - `workStateReason` string, required
    - `workStateUpdatedAt` string, date-time, nullable, required
    - `generatedAt` string, date-time, required
    - `operationalSummary` object, required
      - `text` string, required
      - `source` 'DECISION' | 'BLOCKER' | 'EXECUTION' | 'MISSION' | 'AVAILABILITY', required
      - `sourceId` string, nullable
    - `currentMission` object, nullable, required
      - `id` string, required
      - `title` string, required
      - `status` string, required
      - `href` string, required
    - `currentAction` string, nullable, required
    - `activeLoad` object, required
      - `missions` integer, required
      - `executions` integer, required
    - `recurringResponsibilities` object[], required
      - `id` string, required
      - `name` string, required
      - `status` string, required
    - `lastProduction` object, nullable, required
      - `title` string, required
      - `createdAt` string, date-time, required
      - `href` string, required
    - `autonomySummary` string, required
    - `primaryAction` object, required
      - `kind` 'RESPOND' | 'UNBLOCK' | 'VIEW_PROGRESS' | 'ASSIGN_MISSION', required
      - `label` string, required
      - `href` string, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Filtres du roster invalides
- `401`: Authentification requise
- `404`: Agent absent ou inaccessible dans ce tenant
- `429`: Limite de requêtes atteinte

---

[API](https://skmtc.dev/leadalpes/apis/arcadeops-api.md) · [All operations](https://skmtc.dev/leadalpes/apis/arcadeops-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leadalpes/apis/arcadeops-api/revisions/f10422ec7412?raw)