Saltar al contenido principal
GET
Listar agentes

Listar Agentes

GET /v1/agents Devuelve una lista paginada de todas las identidades de agentes de máquina registradas bajo el inquilino autenticado. Los resultados se pueden filtrar por tipo de agente, estado y nivel de confianza. Los agentes se devuelven en orden cronológico inverso (los más recientes primero).

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

object[]
Matriz de objetos de identidad de agente. Cada objeto contiene el registro completo del agente incluyendo agent_id, agent_type, display_name, status, trust_level, trust_score, scopes, public_key, key_id, metadata, delegation_depth, created_at, y updated_at.
integer
Recuento total de agentes que coinciden con los criterios de filtro, en todas las páginas.

Ejemplo

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Parámetros de consulta

agent_type
enum<string>

Filtrar por tipo de agente

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

Filtrar por estado del agente

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

Número máximo de agentes a devolver

Rango requerido: 1 <= x <= 100
offset
integer

Número de agentes a omitir

Rango requerido: x >= 0

Respuesta

Lista paginada de agentes

items
object[]
total
integer