Inicia una ejecución de flujo de trabajo
Inicia un flujo de trabajo con tus entradas y obtén un id de ejecución a cambio.
POST {base_url}/workflow-runsRequiere runs:write.
Solicitud
POST {base_url}/workflow-runs
Authorization: Bearer mor_live_…
Content-Type: application/json
{
"org_id": "0192f3c1-7a44-7d10-9b22-1e5c8f0a3b61",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"idempotency_key": "story-48213-v2",
"inputs": {
"story_document": "https://cdn.example.com/stories/48213.pdf",
"character_sheets": [
"https://cdn.example.com/chars/48213-a.png",
"https://cdn.example.com/chars/48213-b.png"
],
"episode_count": 8,
"tone": "suspenso"
}
}| Campo del cuerpo | Requerido | Significado |
|---|---|---|
org_id | sí | tu organización; debe coincidir con la de la clave |
project_id | sí | el lienzo donde llegan la ejecución y sus recursos — el id en su URL de Studio, …/editor/<project_id>/canvas |
workflow_id | sí | el flujo de trabajo a ejecutar |
entradas | sí | un objeto indexado por la clave |
idempotency_key | recomendado | hace que un reintento sea seguro — consulta Convenciones |
workflow_version_id | no | fija la versión de la que lees las entradas |
webhook_id | no | envía los eventos de esta ejecución a un punto final registrado — consulta Webhooks |
Cómo enviar cada entrada
acepta | Enviar | Con allow_multiple |
|---|---|---|
valor | la propia cadena, número o booleano | un array de ellos |
url | un enlace HTTPS público, como una cadena | un array de enlaces |
opción | una options[].id, exactamente tal como se da | un array de ids |
Respuesta
202 Accepted
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "en cola",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"chat_id": "0192f3c6-2e75-7b14-9a63-7c4e2d8f1b09",
"ingested": [
{ "input": "story_document", "bytes": 184320, "mime_type": "application/pdf" },
{ "input": "character_sheets", "bytes": 962144, "mime_type": "image/png" },
{ "input": "character_sheets", "bytes": 883021, "mime_type": "image/png" }
],
"poll_after_seconds": 60,
"expires_at": "2026-09-23T04:10:00Z"
}
}| Campo de respuesta | Significado |
|---|---|
id | el id de la ejecución. Consúltalo periódicamente y guárdalo junto con tu propio registro |
estado | en cola al aceptarse |
chat_id | la sesión de Studio en la que ocurre la ejecución. Ábrela para ver la ejecución o responder una pregunta que haga |
ingestado | una entrada por cada archivo recuperado, en el orden enviado. Útil para confirmar que enviaste lo que querías enviar |
poll_after_seconds | cuánto esperar antes de la primera consulta |
expires_at | cuando una ejecución sin terminar se abandona como caducada |
Cada enlace se recupera y verifica antes de el 202. Una ejecución que vuelve aceptada ya tiene sus archivos a mano, así que un enlace incorrecto provoca inmediatamente un 400 en lugar de un fallo diez minutos después.