---
title: "Lista los agentes (Mets) del workspace"
method: GET
path: "/workspaces/{workspaceId}/agents"
tags: ["Agents"]
---

# Lista los agentes (Mets) del workspace

`GET /workspaces/{workspaceId}/agents`

## Request

- Base URL: `https://api.met.meteor.com.co/api/v1`
- URL: `https://api.met.meteor.com.co/api/v1/workspaces/{workspaceId}/agents`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

Los Mets del workspace. De acá sale el id que piden `POST /runs` y los endpoints de vinculación de habilidades.

## Path parameters

- `workspaceId` number, required

## Response `200`

- object: Sobre en el que viaja toda respuesta correcta de la API. El recurso está en `data`. Los SDKs oficiales lo desenvuelven por ti; un cliente hecho a mano tiene que leer `.data`.
  - `success` true, required: Siempre `true` en una respuesta 2xx.
  - `data` AgentResponseDto[], required
    - `active` boolean, required: `false` si el Met está en pausa (no atiende).
    - `created_at` string, nullable, required
    - `disabled_tools` string[], required: Tools que este Met NO verá, aunque se las traiga una skill o una Función. Son claves de tool (`mcp_<handler>_<tool>`), no nombres visibles.
    - `id` number, required: ID del Met. Es el mismo id del item en la colección `_mets`.
    - `instructions` string, nullable, required: Prompt de sistema del Met, tal cual está configurado. `null` si no tiene.
    - `mission` string, nullable, required: Para qué existe este Met. `null` si no se definió.
    - `model` string, nullable, required: Model id configurado para el Met. `null` si usa el default de la plataforma. El ejemplo sale del catálogo y no de un literal: escrito a mano ya se había quedado una versión atrás del modelo real, que es exactamente cómo se desincroniza el catálogo.
    - `name` string, required: Nombre con el que se lo invoca y con el que aparece en los selectores.
    - `object` 'agent', required: Siempre `agent`. Distingue el tipo de objeto en respuestas mezcladas.
    - `tier` 'agil' | 'brillante' | 'genio', nullable, required: Nivel comercial derivado del modelo. `null` si el Met no fija modelo.
    - `title` string, nullable, required: Cargo del Met, el subtítulo que lo describe en una línea. `null` si no tiene.

## Other responses

- `400`: La request no es válida: un campo no pasa validación, falta un parámetro requerido o el recurso no admite la transición solicitada.
- `401`: API key ausente, inválida, revocada o expirada — o el workspace está bloqueado.
- `403`: La key está autenticada pero no puede ejecutar esta operación: scope faltante, capacidad deshabilitada, modo test restringido o recurso fuera de su cartera.
- `404`: El recurso no existe o no está disponible dentro del alcance de la key. No revela la existencia de recursos de otros tenants.
- `429`: Se superó el límite por minuto de la key o la cuota del plan. Respeta `Retry-After`; el SDK ya reintenta solo.
- `500`: Error del servidor o del Met que ejecutaba. El SDK reintenta los 5xx con backoff.

---

[API](https://skmtc.dev/meteor/apis/met-public-api.md) · [All operations](https://skmtc.dev/meteor/apis/met-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meteor/apis/met-public-api/revisions/5d9ca294295c?raw)