Passer au contenu principal
GET
Lister les agents

Lister les agents

GET /v1/agents Renvoie une liste paginée de toutes les identités d’agent machine enregistrées sous le locataire authentifié. Les résultats peuvent être filtrés par type d’agent, statut et niveau de confiance. Les agents sont renvoyés par ordre chronologique inverse (les plus récents en premier).

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Réponse

object[]
Tableau d’objets d’identité d’agent. Chaque objet contient l’enregistrement complet de l’agent y compris agent_id, agent_type, display_name, status, trust_level, trust_score, scopes, public_key, key_id, metadata, delegation_depth, created_at, et updated_at.
integer
Nombre total d’agents correspondant aux critères de filtre, sur toutes les pages.

Exemple

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de requête

agent_type
enum<string>

Filtrer par type d'agent

Options disponibles:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
status
enum<string>

Filtrer par statut de l'agent

Options disponibles:
active,
suspended,
revoked
trust_level
string
limit
integer

Nombre maximal d'agents à retourner

Plage requise: 1 <= x <= 100
offset
integer

Nombre d'agents à ignorer

Plage requise: x >= 0

Réponse

Liste paginée des agents

items
object[]
total
integer