Ejecuciones y asociaciones

Listar ejecuciones

GET /flows/:id/executions

Historial de ejecuciones de un flujo, de la mas reciente a la mas antigua.

Query Parameters

Parametro	Tipo	Descripcion
`limit`	number	Resultados por pagina. Default 50
`skip`	number	Cuantos registros saltar. Default 0

curl "https://api.mirlo.com/v1/flows/{flow_id}/executions?limit=20" \
  -H "X-API-Key: sk_live_..."

Respuesta

{
  "data": [
    {
      "id": "0f3c1a52-6d2e-4b8a-9a51-2b7e4c9d1f10",
      "flow_id": "6b1f0c1e-3c5e-4a43-9d57-0a6c2f5d9e11",
      "flow_version": 3,
      "status": "completed",
      "trigger_type": "manual",
      "trigger_payload": { "text": "hola" },
      "call_sid": null,
      "caller_number": null,
      "phone_number": null,
      "current_node_id": null,
      "variables": {},
      "started_at": "2026-10-10T18:20:00.000Z",
      "completed_at": "2026-10-10T18:20:02.000Z",
      "error": null,
      "execution_path": [],
      "steps_executed": 4
    }
  ],
  "total": 128
}

Campo	Descripcion
`status`	`pending`, `running`, `waiting`, `completed`, `failed`, `cancelled`
`trigger_type`	Que la disparo (por ejemplo `manual` en las pruebas)
`call_sid`, `caller_number`, `phone_number`	Datos de llamada tomados del payload del disparador (`callSid`, `from`, `to`); `null` si no aplica
`current_node_id`	Paso en el que esta o quedo la ejecucion
`error`	Mensaje de error si fallo
`steps_executed`	Cantidad de pasos ejecutados

Detalle de una ejecucion

GET /flows/:id/executions/:executionId

executionId debe ser un UUID; si no, la respuesta es 400. Devuelve los mismos campos que el listado (sin steps_executed) mas los pasos y los logs:

{
  "id": "0f3c1a52-6d2e-4b8a-9a51-2b7e4c9d1f10",
  "status": "completed",
  "steps": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000000",
      "step_id": "n2",
      "status": "completed",
      "input": { },
      "output": { },
      "started_at": "2026-10-10T18:20:00.500Z",
      "completed_at": "2026-10-10T18:20:01.000Z",
      "duration_ms": 500
    }
  ],
  "logs": [
    { "level": "info", "message": "n2", "timestamp": "2026-10-10T18:20:01.000Z" }
  ]
}

Flujos que usan un agente

GET /flows/by-agent/:agentId

Lista los flujos que referencian a un agente (nodos de ruteo a agente, a IA o de asignacion de miembro). Requiere flows:view o agents:view.

{
  "agentId": "<agent_id>",
  "flows": [ { "id": "...", "name": "...", "status": "active", "channel": "messaging" } ]
}

Numeros asociados a flujos

GET /flows/phone-numbers/mappings

Devuelve un objeto indexado por phoneNumberId con el flujo activo asociado a cada numero. Requiere flows:view o calls.settings:view.

Parametro	Tipo	Descripcion
`triggerType`	string	Limita a un tipo de disparador. Recomendado: un mismo numero puede estar en un flujo por tipo

{
  "<phone_number_id>": {
    "flowId": "6b1f0c1e-3c5e-4a43-9d57-0a6c2f5d9e11",
    "flowName": "Atencion inicial",
    "flowStatus": "active",
    "phoneNumber": "+5215512345678"
  }
}