> ## Documentation Index > Fetch the complete documentation index at: https://docs.getsupervisor.ai/llms.txt > Use this file to discover all available pages before exploring further. # Stream de llamadas > Obtiene llamadas en orden ascendente (por `startedAt`) a partir de un cursor temporal. Útil para sincronizaciones incrementales. ## OpenAPI ````yaml /openapi/public-api.yaml get /v1/calls/stream openapi: 3.1.0 info: title: Agents Studio API version: 1.0.0 description: > API del backend de Agents Studio. Expone servicios multi-tenant para gestionar agentes (texto y voz), catálogo de herramientas, habilitación de workspaces y operaciones de telefonía. Todos los endpoints requieren autenticación Bearer y respetan los contratos documentados en `docs/modules`. license: name: Proprietary url: https://getsupervisor.ai/legal/terms servers: - url: https://api-prod.studio.getsupervisor.ai description: Producción - url: https://sandbox.agents.studio.getsupervisor.ai description: Sandbox security: - BearerAuth: [] tags: - name: Agents description: > Gestión general de agentes y sus metadatos. Scopes requeridos: `agents:read` para consultas y `agents:write` para creación, actualización y operaciones sobre teléfonos. - name: Agent Versions description: Versionado y mantenimiento de versiones publicadas de los agentes. - name: Agent Schedules description: >- Configuración de horarios regulares y excepciones puntuales para controlar la disponibilidad de los agentes. - name: Agent Knowledge description: Uploads y sincronización de knowledge bases asociadas al agente. - name: Agent Tags description: Gestión de etiquetas asociadas a agentes. - name: Campaigns description: > Gestión de campañas masivas basadas en CSV para ejecutar agentes de forma batch. Scopes requeridos: `campaigns:read` para consultas y `campaigns:write` para creación. - name: Calls description: | Consultas de llamadas (Speech Analytics) disponibles para el workspace. Scopes requeridos: `calls:read`. - name: Knowledge description: Gestión de recursos de conocimiento asociados a tools. - name: Agent Instructions description: > Operaciones sobre instrucciones (prompt) gestionadas por los usuarios finales para guiar y corregir el comportamiento del agente. Las instrucciones se aplican a la versión activa del agente, se mantienen como texto libre sin formato (1 a 500 caracteres) y su prioridad se controla mediante el campo `order`. Scopes requeridos: `agent-instructions:read` para consultas y `agent-instructions:write` para creación o edición. - name: Voices description: Catálogo consolidado de voces provenientes de proveedores externos. - name: Catalogs description: > Gestión centralizada de catálogos (idiomas, tonos, voces, etiquetas) con alcance global o específico por workspace. Scopes requeridos: `catalogs:read` para consultas y `catalogs:write` para creación y modificaciones. - name: Agent Phones description: Conexión y desconexión de teléfonos asignados a agentes. - name: API Keys description: Gestión de credenciales de acceso programático y sus permisos. - name: Agent Blueprints description: > Gestión del blueprint (personalidad) asociado a cada versión de agente. Scopes requeridos: `agent-blueprints:read` para lectura y `agent-blueprints:write` para cambios en blueprint. - name: Agent Stages description: > Autoría de stages del blueprint del agente, abarcando orden, prompts y validaciones previas a la publicación. Scopes requeridos: `stages:read` para consultas y `stages:write` para creación y edición. La validación se ejecuta automáticamente en cada mutación y la sincronización con proveedores sucede mediante jobs internos tras los cambios. - name: Stage Triggers description: > Gestión detallada de triggers que conectan stages dentro del blueprint y definen las transiciones conversacionales. Scopes requeridos: `stage-triggers:*` (o políticas equivalentes bajo `stages:*`). - name: Workspaces description: Gestión multi-tenant y habilitación de credenciales por workspace. - name: Tools description: > Catálogo y ejecución de tools disponibles para los agentes. Scopes requeridos: `tools:read` para listar y `tools:execute` para ejecutar tools. - name: Webhooks description: > Gestión de webhooks por workspace para suscribirse a eventos del dominio y recibir notificaciones HTTP. Scopes requeridos: `webhooks:read` para consultas y `webhooks:write` para crear, actualizar o eliminar webhooks y suscripciones. paths: /v1/calls/stream: get: tags: - Calls summary: Stream de llamadas description: > Obtiene llamadas en orden ascendente (por `startedAt`) a partir de un cursor temporal. Útil para sincronizaciones incrementales. operationId: streamCalls parameters: - $ref: '#/components/parameters/XWorkspaceId' - $ref: '#/components/parameters/CallsAfterParam' - $ref: '#/components/parameters/CallsStreamLimitParam' - $ref: '#/components/parameters/AgentBatchIdQuery' - $ref: '#/components/parameters/AgentIdQuery' - $ref: '#/components/parameters/ExecutionIdQuery' - $ref: '#/components/parameters/DurationBucketQuery' - $ref: '#/components/parameters/GoalStatusQuery' - $ref: '#/components/parameters/SearchQuery' responses: '200': description: Página del stream de llamadas content: application/json: schema: $ref: '#/components/schemas/CallsStreamResponse' examples: default: summary: Stream de llamadas value: data: - id: d7e0d9b2-8d8d-4cbb-a4d5-9a52c6b59d2f title: Llamada de soporte customerPhone: '+5215555555555' durationSeconds: 312 supervisors: evaluations: 1 discoveries: 0 risks: 0 goal: achieved: true reason: null startedAt: '2025-10-03T10:15:11.004Z' recordingUrl: https://example.com/recordings/d7e0d9b2.mp3 agentBatchId: null agentId: 5769e110-7267-4cf7-a3ca-2d06e8fffbb3 executionId: exec_01J9Z1F9H2 meta: limit: 50 nextAfter: '2025-10-03T10:15:11.004Z' '400': description: Parámetros inválidos content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: INVALID_QUERY message: El parámetro after debe ser una fecha ISO-8601 válida components: parameters: XWorkspaceId: name: x-workspace-id in: header required: true description: Identificador del workspace multi-tenant. schema: type: string format: uuid CallsAfterParam: name: after in: query required: true description: >- Cursor temporal (ISO-8601). Retorna llamadas con `startedAt` estrictamente mayor a este valor. schema: type: string format: date-time CallsStreamLimitParam: name: limit in: query required: false description: Cantidad máxima de elementos a retornar (1..100). Por defecto 50. schema: type: integer minimum: 1 maximum: 100 default: 50 AgentBatchIdQuery: name: agentBatchId in: query required: false description: >- Filtra llamadas por identificador de batch (campaign/agent batch) asociado. schema: type: string format: uuid AgentIdQuery: name: agentId in: query required: false description: Filtra llamadas por identificador del agente asociado. schema: type: string format: uuid ExecutionIdQuery: name: executionId in: query required: false description: Filtra llamadas por identificador de ejecución asociado. schema: type: string DurationBucketQuery: name: durationBucket in: query required: false description: Filtra por duración ('short' < 60s, 'medium' 60-300s, 'long' > 300s). schema: type: string enum: - short - medium - long GoalStatusQuery: name: goalStatus in: query required: false description: Filtra por estado del objetivo ('achieved', 'not_achieved'). schema: type: string enum: - achieved - not_achieved SearchQuery: name: query in: query required: false description: Búsqueda de texto en título y teléfono/participantes. schema: type: string schemas: CallsStreamResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/Call' meta: $ref: '#/components/schemas/CallsStreamMeta' required: - data - meta ErrorResponse: type: object properties: code: type: string description: Código principal del error (alto nivel). message: type: string description: Mensaje legible para humanos. details: type: object description: > Información adicional específica del error. Cuando aplique, `details.subcode` provee un identificador estable para que el frontend decida qué UI mostrar. properties: subcode: type: string description: >- Identificador específico del error (p.ej. `WORKSPACE_NOT_PROVISIONED`). workspaceId: type: string format: uuid description: Identificador de workspace relacionado cuando aplica. additionalProperties: true required: - code - message Call: type: object properties: id: type: string format: uuid title: type: string customerPhone: type: - string - 'null' durationSeconds: type: - integer - 'null' minimum: 0 supervisors: $ref: '#/components/schemas/CallSupervisors' goal: $ref: '#/components/schemas/CallGoal' startedAt: type: string format: date-time recordingUrl: type: - string - 'null' format: uri agentBatchId: type: - string - 'null' format: uuid agentId: type: - string - 'null' format: uuid executionId: type: - string - 'null' required: - id - title - customerPhone - durationSeconds - supervisors - goal - startedAt - recordingUrl - agentBatchId - agentId - executionId additionalProperties: false CallsStreamMeta: type: object properties: limit: type: integer minimum: 1 maximum: 100 nextAfter: type: - string - 'null' format: date-time description: Cursor para la siguiente página del stream. required: - limit - nextAfter additionalProperties: false CallSupervisors: type: object properties: evaluations: type: - number - 'null' discoveries: type: - number - 'null' risks: type: - number - 'null' required: - evaluations - discoveries - risks additionalProperties: false CallGoal: type: object properties: achieved: type: boolean reason: type: - string - 'null' required: - achieved - reason additionalProperties: false securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ````