# Agents Studio Docs ## Docs - [Actualizar blueprint de una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-blueprints/actualizar-blueprint-de-una-versión-del-agente.md) - [Crear blueprint para una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-blueprints/crear-blueprint-para-una-versión-del-agente.md) - [Listar blueprints asociados al agente](https://docs.getsupervisor.ai/api-reference/agent-blueprints/listar-blueprints-asociados-al-agente.md) - [Obtener blueprint de una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-blueprints/obtener-blueprint-de-una-versión-del-agente.md) - [Agregar una instrucción a la versión del agente](https://docs.getsupervisor.ai/api-reference/agent-instructions/agregar-una-instrucción-a-la-versión-del-agente.md) - [Editar una instrucción existente](https://docs.getsupervisor.ai/api-reference/agent-instructions/editar-una-instrucción-existente.md) - [Eliminar una instrucción](https://docs.getsupervisor.ai/api-reference/agent-instructions/eliminar-una-instrucción.md): Elimina la instrucción sin borrar su historial. - [Listar instrucciones de una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-instructions/listar-instrucciones-de-una-versión-del-agente.md) - [Conectar un teléfono a un agente](https://docs.getsupervisor.ai/api-reference/agent-phones/conectar-un-teléfono-a-un-agente.md) - [Desconectar un teléfono del agente](https://docs.getsupervisor.ai/api-reference/agent-phones/desconectar-un-teléfono-del-agente.md) - [Listar teléfonos disponibles del workspace](https://docs.getsupervisor.ai/api-reference/agent-phones/listar-teléfonos-disponibles-del-workspace.md) - [Actualizar excepción puntual del horario](https://docs.getsupervisor.ai/api-reference/agent-schedules/actualizar-excepción-puntual-del-horario.md) - [Actualizar un horario existente del agente](https://docs.getsupervisor.ai/api-reference/agent-schedules/actualizar-un-horario-existente-del-agente.md) - [Crear excepción puntual del horario](https://docs.getsupervisor.ai/api-reference/agent-schedules/crear-excepción-puntual-del-horario.md) - [Crear un nuevo horario para el agente](https://docs.getsupervisor.ai/api-reference/agent-schedules/crear-un-nuevo-horario-para-el-agente.md) - [Eliminar excepción puntual del horario](https://docs.getsupervisor.ai/api-reference/agent-schedules/eliminar-excepción-puntual-del-horario.md) - [Listar excepciones del horario configurado](https://docs.getsupervisor.ai/api-reference/agent-schedules/listar-excepciones-del-horario-configurado.md): Devuelve las excepciones puntuales que alteran la disponibilidad estándar del agente. Utiliza los parámetros `filter` y `or` (ver `docs/api-query-builder.md`) para limitar por fecha (`exceptionDate`), rango, identificadores u otros campos permitidos. - [Listar horarios configurados del agente](https://docs.getsupervisor.ai/api-reference/agent-schedules/listar-horarios-configurados-del-agente.md): Devuelve la colección paginada de horarios estándar registrados para un agente. Soporta filtros avanzados mediante el API Query Builder (`filter` y `or`) para localizar configuraciones específicas por `timezone`, fechas de creación u otros campos. - [Obtener detalle de un horario del agente](https://docs.getsupervisor.ai/api-reference/agent-schedules/obtener-detalle-de-un-horario-del-agente.md) - [Obtener excepción puntual del horario](https://docs.getsupervisor.ai/api-reference/agent-schedules/obtener-excepción-puntual-del-horario.md) - [Actualizar un stage existente](https://docs.getsupervisor.ai/api-reference/agent-stages/actualizar-un-stage-existente.md): Aplica cambios parciales sobre un stage del blueprint. Antes de persistir se corre la validación completa del grafo; si falla retorna `400 INVALID_GRAPH`. Tras la actualización exitosa se publica un evento `BlueprintStageUpdated` que el job `StagesSyncJob` consume para sincronizar el grafo completo… - [Crear un stage dentro del blueprint del agente](https://docs.getsupervisor.ai/api-reference/agent-stages/crear-un-stage-dentro-del-blueprint-del-agente.md): Persiste un nuevo stage en el blueprint editable del agente. Antes de guardar se ejecuta la validación completa del grafo; en caso de error se responde `400 INVALID_GRAPH`. Una vez confirmada la creación se emite un evento `BlueprintStageCreated` que desencadena el job interno `StagesSyncJob` para r… - [Eliminar un stage del blueprint](https://docs.getsupervisor.ai/api-reference/agent-stages/eliminar-un-stage-del-blueprint.md): Remueve el stage y desconecta sus triggers asociados. El evento `BlueprintStageDeleted` se emite al finalizar y provoca que `StagesSyncJob` vuelva a generar el payload del proveedor de voz/LLM. - [Listar stages del blueprint activo del agente](https://docs.getsupervisor.ai/api-reference/agent-stages/listar-stages-del-blueprint-activo-del-agente.md): Devuelve los stages configurados para el blueprint editable del agente, incluyendo prompts y triggers asociados. La respuesta es paginada para facilitar la edición incremental desde el frontend. - [Obtener detalle de un stage específico](https://docs.getsupervisor.ai/api-reference/agent-stages/obtener-detalle-de-un-stage-específico.md) - [Reordenar los stages del blueprint](https://docs.getsupervisor.ai/api-reference/agent-stages/reordenar-los-stages-del-blueprint.md): Actualiza el orden de los stages dentro del blueprint y define el stage inicial (opcional). El nuevo orden se aplica de forma atómica y devuelve la lista resultante para mantener el editor sincronizado. Después del cambio se publica `BlueprintStageReordered` y el job `StagesSyncJob` recalcula el pay… - [Asociar una etiqueta al agente](https://docs.getsupervisor.ai/api-reference/agent-tags/asociar-una-etiqueta-al-agente.md) - [Eliminar una etiqueta del agente](https://docs.getsupervisor.ai/api-reference/agent-tags/eliminar-una-etiqueta-del-agente.md) - [Actualizar notas de una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-versions/actualizar-notas-de-una-versión-del-agente.md) - [Clonar una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-versions/clonar-una-versión-del-agente.md) - [Crear una nueva versión del agente](https://docs.getsupervisor.ai/api-reference/agent-versions/crear-una-nueva-versión-del-agente.md) - [Listar versiones configuradas del agente](https://docs.getsupervisor.ai/api-reference/agent-versions/listar-versiones-configuradas-del-agente.md) - [Obtener detalle de una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-versions/obtener-detalle-de-una-versión-del-agente.md) - [Publicar una versión del agente](https://docs.getsupervisor.ai/api-reference/agent-versions/publicar-una-versión-del-agente.md): Promueve una versión `draft` a `active` (archivando la versión activa previa) o re-publica una versión ya `active` para forzar la sincronización sin crear versiones adicionales. La operación es idempotente y puede ejecutarse varias veces sobre la misma versión para actualizar prompts, herramientas,… - [Actualizar atributos configurables del agente](https://docs.getsupervisor.ai/api-reference/agents/actualizar-atributos-configurables-del-agente.md): Permite ajustar campos operativos (nombre, estado, metadata) sin recrear el agente. Soporta actualizaciones parciales siguiendo semántica `PATCH`. - [Clonar un agente](https://docs.getsupervisor.ai/api-reference/agents/clonar-un-agente.md): Crea un nuevo agente en el workspace activo clonando selectivamente atributos desde un agente existente. - [Crear agente a partir de una plantilla (fork de agent_version)](https://docs.getsupervisor.ai/api-reference/agents/crear-agente-a-partir-de-una-plantilla-fork-de-agent_version.md): Clona la configuración publicada de una plantilla del catálogo y crea un nuevo agente inactivo en el workspace activo. Se replica el blueprint, stages, triggers e instrucciones del `agent_version` origen dentro de una nueva versión en borrador. - [Crear un agente y su versión inicial](https://docs.getsupervisor.ai/api-reference/agents/crear-un-agente-y-su-versión-inicial.md): Registra un nuevo agente junto con su primera versión de configuración. Ideal para habilitar rápidamente nuevos casos de uso (soporte, ventas, cobranza) manteniendo trazabilidad multi-tenant. - [Eliminar un agente](https://docs.getsupervisor.ai/api-reference/agents/eliminar-un-agente.md): Despublica y elimina el agente indicado junto con sus versiones asociadas. Útil para limpiar pilotos obsoletos o agentes en desuso. - [Listar agentes del workspace](https://docs.getsupervisor.ai/api-reference/agents/listar-agentes-del-workspace.md): Obtiene un catálogo paginado de agentes (chat y voz) visibles para el workspace activo. Incluye metadatos de negocio como estado operativo, proveedor y etiquetas para construir tableros de monitoreo y métricas de automatización. - [Obtener detalle de un agente](https://docs.getsupervisor.ai/api-reference/agents/obtener-detalle-de-un-agente.md): Retorna la ficha operativa del agente, combinando metadata local y configuraciones activas en el proveedor externo. Útil para auditorías, monitoreo y resolución de incidencias. - [Crear una API Key](https://docs.getsupervisor.ai/api-reference/api-keys/crear-una-api-key.md): Genera una nueva API Key asociada al usuario autenticado y al workspace activo. La respuesta incluye el valor completo de la llave **solo una vez**, por lo que debe almacenarse de manera segura inmediatamente. - [Listar API Keys activas del usuario](https://docs.getsupervisor.ai/api-reference/api-keys/listar-api-keys-activas-del-usuario.md): Recupera las credenciales API activas creadas por el usuario autenticado para el workspace indicado. Incluye metadatos como entorno, scopes autorizados y la fecha del último uso para facilitar auditorías rápidas. - [Mostrar valor completo de una API Key](https://docs.getsupervisor.ai/api-reference/api-keys/mostrar-valor-completo-de-una-api-key.md): Devuelve el valor completo de una API Key activa. Esta operación está auditada y debe usarse únicamente cuando el usuario necesite recuperar la credencial. Si la llave ya fue revocada o no puede desencriptarse, se responderá 404. - [Revocar una API Key](https://docs.getsupervisor.ai/api-reference/api-keys/revocar-una-api-key.md): Revoca una API Key previamente emitida. Una vez ejecutado, la credencial deja de ser válida de forma inmediata y su uso posterior regresará errores de autenticación. - [Listar llamadas](https://docs.getsupervisor.ai/api-reference/calls/listar-llamadas.md): Obtiene un listado paginado de llamadas disponibles para el workspace activo. Este recurso es de solo lectura y se alimenta desde Speech Analytics. - [Obtener llamada por id](https://docs.getsupervisor.ai/api-reference/calls/obtener-llamada-por-id.md): Obtiene el detalle de una llamada específica. - [Stream de llamadas](https://docs.getsupervisor.ai/api-reference/calls/stream-de-llamadas.md): Obtiene llamadas en orden ascendente (por `startedAt`) a partir de un cursor temporal. Útil para sincronizaciones incrementales. - [Crear campaña para una versión específica del agente](https://docs.getsupervisor.ai/api-reference/campaigns/crear-campaña-para-una-versión-específica-del-agente.md): Sube un archivo CSV, valida las columnas contra el blueprint activo y crea una campaña en estado `PENDING`. El archivo se almacena en el bucket interno y se encola un evento para procesamiento asíncrono. Requiere el scope `campaigns:write`. - [Listar campañas masivas](https://docs.getsupervisor.ai/api-reference/campaigns/listar-campañas-masivas.md): Retorna campañas ejecutadas mediante cargas CSV para un workspace. Soporta filtros, ordenamientos y paginación siguiendo la convención descrita en `docs/api-query-builder.md`. Requiere el scope `campaigns:read`. - [Listar ejecuciones individuales de una campaña](https://docs.getsupervisor.ai/api-reference/campaigns/listar-ejecuciones-individuales-de-una-campaña.md): Expone el progreso fila por fila, incluyendo errores capturados. Requiere el scope `campaigns:read`. Cada elemento incluye `agentExecutionId` cuando existe una ToolExecution asociada, lo que permite correlacionar la fila con la ejecución del servicio de tools. - [Obtener detalle de una campaña](https://docs.getsupervisor.ai/api-reference/campaigns/obtener-detalle-de-una-campaña.md): Devuelve metadatos completos y métricas consolidadas de la campaña. - [Crear ítem de catálogo](https://docs.getsupervisor.ai/api-reference/catalogs/crear-ítem-de-catálogo.md): Registra un nuevo ítem en el catálogo seleccionado. Para `scope=workspace` debe enviarse el header `x-workspace-id`. Requiere el scope `catalogs:write`. - [Eliminar (soft delete) un ítem de catálogo](https://docs.getsupervisor.ai/api-reference/catalogs/eliminar-soft-delete-un-ítem-de-catálogo.md): Marca el ítem como eliminado (`deleted_at`) siempre que no tenga referencias activas. Requiere el scope `catalogs:write`. - [Listar ítems de catálogo](https://docs.getsupervisor.ai/api-reference/catalogs/listar-ítems-de-catálogo.md): Retorna el catálogo consolidado (global + workspace) respetando filtros por tipo y workspace. Soporta paginación, orden por nombre y filtros avanzados basados en la convención del API Query Builder (`docs/api-query-builder.md`). Requiere el scope `catalogs:read`. - [Obtener detalle de un ítem de catálogo](https://docs.getsupervisor.ai/api-reference/catalogs/obtener-detalle-de-un-ítem-de-catálogo.md): Recupera la ficha completa de un ítem, incluyendo metadata específica y enlaces HATEOAS. Requiere el scope `catalogs:read`. - [Calls](https://docs.getsupervisor.ai/api-reference/endpoint/calls.md): Consultar llamadas (Speech Analytics) asociadas al workspace. - [Campaigns](https://docs.getsupervisor.ai/api-reference/endpoint/campaigns.md): Gestiona campañas masivas basadas en CSV para ejecutar agentes en batch. - [Q&A](https://docs.getsupervisor.ai/api-reference/endpoint/knowledge.md): Responde preguntas usando el conocimiento del agente (Knowledge Base) - [Configurar webhook](https://docs.getsupervisor.ai/api-reference/endpoint/notifications.md): Crea un webhook permitiendo asociar opcionalmente un agente y reutilizar URLs existentes. - [Iniciar llamada](https://docs.getsupervisor.ai/api-reference/endpoint/phone-call.md): Ejecuta la tool de voz `voice.calls` usando la acción `startCall`. - [Stages y triggers](https://docs.getsupervisor.ai/api-reference/endpoint/stages.md): Endpoints REST para manejar stages de blueprint y sus triggers conversacionales. - [Plantillas de agentes](https://docs.getsupervisor.ai/api-reference/endpoint/templates.md): Clona agentes vocales listos para producción con blueprints y stages prediseñados. - [Tools](https://docs.getsupervisor.ai/api-reference/endpoint/tools.md): Catálogo, conexiones y ejecución de tools disponibles para los agentes. - [Webhooks](https://docs.getsupervisor.ai/api-reference/endpoint/webhook.md): Configure webhooks to receive real-time notifications when events occur in your workspace - [API Reference](https://docs.getsupervisor.ai/api-reference/introduction.md): Guía práctica para consumir la Public API con TypeScript (SDK oficial) o llamadas HTTP/cURL. - [Keys](https://docs.getsupervisor.ai/api-reference/keys.md): Cómo obtener y usar tu API Key por espacio de trabajo - [Cargar un recurso de conocimiento](https://docs.getsupervisor.ai/api-reference/knowledge/cargar-un-recurso-de-conocimiento.md) - [Eliminar un recurso de conocimiento](https://docs.getsupervisor.ai/api-reference/knowledge/eliminar-un-recurso-de-conocimiento.md) - [Listar recursos de conocimiento asociados a una tool](https://docs.getsupervisor.ai/api-reference/knowledge/listar-recursos-de-conocimiento-asociados-a-una-tool.md) - [Reprocesar o regenerar embeddings del recurso](https://docs.getsupervisor.ai/api-reference/knowledge/reprocesar-o-regenerar-embeddings-del-recurso.md) - [Host MCP](https://docs.getsupervisor.ai/api-reference/mcp.md): Cómo interactuar con las capabilities MCP del backend de Agents Studio. - [Listar voces](https://docs.getsupervisor.ai/api-reference/miscellaneous.md): Consulta el catálogo de voces disponibles en tu workspace. - [TypeScript SDK](https://docs.getsupervisor.ai/api-reference/sdk.md): Integra la Public API usando @getsupervisor/agents-studio-sdk, con ejemplos prácticos y convenciones recomendadas. - [Actualizar un trigger existente](https://docs.getsupervisor.ai/api-reference/stage-triggers/actualizar-un-trigger-existente.md): Modifica campos seleccionados de un trigger. La validación completa del grafo se ejecuta antes de confirmar los cambios y retorna `400 INVALID_GRAPH` cuando la transición rompe invariantes. El evento `BlueprintStageTriggerUpdated` se publica tras aplicar los cambios y `StagesSyncJob` reaplica el gra… - [Crear trigger para un stage](https://docs.getsupervisor.ai/api-reference/stage-triggers/crear-trigger-para-un-stage.md): Registra un nuevo trigger asociado al stage indicado. La validación del grafo se ejecuta de forma automática y responde `400 INVALID_GRAPH` cuando la transición rompe invariantes. El evento `BlueprintStageTriggerCreated` se publica al finalizar y el job `StagesSyncJob` vuelve a generar el payload de… - [Eliminar un trigger del stage](https://docs.getsupervisor.ai/api-reference/stage-triggers/eliminar-un-trigger-del-stage.md): Elimina el trigger y deja el grafo listo para recalcular rutas. El evento `BlueprintStageTriggerDeleted` se emite y provoca una ejecución asincrónica del job de sincronización con el proveedor. - [Listar triggers de un stage](https://docs.getsupervisor.ai/api-reference/stage-triggers/listar-triggers-de-un-stage.md) - [Obtener detalle de un trigger](https://docs.getsupervisor.ai/api-reference/stage-triggers/obtener-detalle-de-un-trigger.md) - [Agendar llamada](https://docs.getsupervisor.ai/api-reference/telephony/schedule-call.md): Programa una llamada diferida con la tool `schedule_call_tool`. - [Crear una conexión entre un agente y la tool indicada](https://docs.getsupervisor.ai/api-reference/tools/crear-una-conexión-entre-un-agente-y-la-tool-indicada.md) - [Crear una conexión entre un agente y una tool (por body)](https://docs.getsupervisor.ai/api-reference/tools/crear-una-conexión-entre-un-agente-y-una-tool-por-body.md) - [Ejecutar una acción de la tool para el agente indicado](https://docs.getsupervisor.ai/api-reference/tools/ejecutar-una-acción-de-la-tool-para-el-agente-indicado.md) - [Ejecutar una acción de una tool usando el toolAgentConnectionId](https://docs.getsupervisor.ai/api-reference/tools/ejecutar-una-acción-de-una-tool-usando-el-toolagentconnectionid.md) - [Geocoding](https://docs.getsupervisor.ai/api-reference/tools/geocoding.md): Obtén coordenadas y direcciones normalizadas con la tool `geocoding`. - [Listar catálogo de tools disponibles](https://docs.getsupervisor.ai/api-reference/tools/listar-catálogo-de-tools-disponibles.md) - [Listar conexiones entre agentes y tools](https://docs.getsupervisor.ai/api-reference/tools/listar-conexiones-entre-agentes-y-tools.md) - [Listar voces disponibles para el workspace](https://docs.getsupervisor.ai/api-reference/voices/listar-voces-disponibles-para-el-workspace.md) - [Actualizar suscripción](https://docs.getsupervisor.ai/api-reference/webhooks/actualizar-suscripción.md) - [Actualizar webhook](https://docs.getsupervisor.ai/api-reference/webhooks/actualizar-webhook.md): Actualiza campos opcionales del webhook, incluida la asociación a un agente y la URL sin restricciones de unicidad. - [Crear suscripción de evento para un webhook](https://docs.getsupervisor.ai/api-reference/webhooks/crear-suscripción-de-evento-para-un-webhook.md) - [Crear webhook](https://docs.getsupervisor.ai/api-reference/webhooks/crear-webhook.md): Crea un webhook permitiendo asociar opcionalmente un agente y reutilizar URLs existentes. - [Eliminar suscripción](https://docs.getsupervisor.ai/api-reference/webhooks/eliminar-suscripción.md) - [Eliminar webhook (soft-delete)](https://docs.getsupervisor.ai/api-reference/webhooks/eliminar-webhook-soft-delete.md) - [Listar deliveries de un webhook](https://docs.getsupervisor.ai/api-reference/webhooks/listar-deliveries-de-un-webhook.md): Lista los intentos de entrega (deliveries) generados para un webhook. Soporta `filter=` (API Query Builder) para filtrar por `eventKey`, `status`, etc. - [Listar suscripciones de un webhook](https://docs.getsupervisor.ai/api-reference/webhooks/listar-suscripciones-de-un-webhook.md) - [Listar webhooks del workspace](https://docs.getsupervisor.ai/api-reference/webhooks/listar-webhooks-del-workspace.md): Lista webhooks configurados en el workspace actual utilizando el API Query Builder (sin `or`). - [Obtener delivery por ID](https://docs.getsupervisor.ai/api-reference/webhooks/obtener-delivery-por-id.md) - [Obtener detalle de una suscripción](https://docs.getsupervisor.ai/api-reference/webhooks/obtener-detalle-de-una-suscripción.md) - [Obtener detalle de webhook](https://docs.getsupervisor.ai/api-reference/webhooks/obtener-detalle-de-webhook.md) - [Habilitar un workspace (API key, teléfono y Speech Analytics)](https://docs.getsupervisor.ai/api-reference/workspaces/habilitar-un-workspace-api-key-teléfono-y-speech-analytics.md) - [Listar workspaces usando caché local](https://docs.getsupervisor.ai/api-reference/workspaces/listar-workspaces-usando-caché-local.md) - [Crear un agente conversando con otro agente: Copilot al rescate](https://docs.getsupervisor.ai/blog/crear-agente-con-copilot.md): La manera más rápida de pasar de 'tengo una idea' a 'tengo un agente funcionando', sin abrir veinte pantallas. - [Tu primer agente en 15 minutos: como contratar a un empleado, pero en la nube](https://docs.getsupervisor.ai/blog/crear-agente-desde-cero.md): Un paseo honesto, sin tecnicismos de más, por la forma en que se arma un agente de voz en Agents Studio. - [Blog](https://docs.getsupervisor.ai/blog/index.md): Guías, historias y lecciones aprendidas construyendo con Agents Studio. Sin tecnicismos de más. - [Tu primera campaña: de una llamada a miles](https://docs.getsupervisor.ai/blog/lanzar-tu-primera-campana.md): Lo que cambia entre probar un agente y mandarlo a hablarle a mil personas al mismo tiempo. - [Tu primera llamada de prueba: el momento de la verdad](https://docs.getsupervisor.ai/blog/lanzar-tu-primera-llamada.md): Un paso a paso honesto de cómo lanzar la primera llamada, qué esperar, y cómo leer lo que pasó. - [De borrador a estrella: cómo se publica un agente sin morir en el intento](https://docs.getsupervisor.ai/blog/publicar-tu-primer-agente.md): Publicar suena a trámite, pero es el paso donde la mayoría se tropieza. Aquí va lo que nadie te explica. - [Variables de entrada y salida: lo que le contamos al agente y lo que nos cuenta de vuelta](https://docs.getsupervisor.ai/blog/variables-entrada-y-salida.md): El concepto que destraba todo lo que viene después: campañas, integraciones, reportes… Todo pasa por aquí. - [Mismo truco, otra caja de herramientas: Make](https://docs.getsupervisor.ai/blog/webhook-make-envio-correo.md): El mismo caso de uso que con n8n, pero con la plataforma que mucha gente de marketing prefiere. - [De webhook a correo con n8n en 10 minutos](https://docs.getsupervisor.ai/blog/webhook-n8n-envio-correo.md): Un paso a paso real para que, cada vez que termine una llamada, se dispare un correo sin que muevas un dedo. - [Webhooks sin miedo: cómo tu agente le habla al resto del mundo](https://docs.getsupervisor.ai/blog/webhooks-conectar-y-suscribir.md): La palabra asusta. El concepto es de primaria. Prometo. ## OpenAPI Specs - [public-api](https://docs.getsupervisor.ai/openapi/public-api.yaml) - [openapi](https://docs.getsupervisor.ai/api-reference/openapi.json)