Lire une exécution de workflow
Suivez une exécution jusqu’à un état terminal et récupérez ses éléments.
GET {base_url}/workflow-runs/{run_id}
GET {base_url}/workflow-runs/{run_id}?wait=45Nécessite runs:read.
attendez maintient la réponse ouverte pendant jusqu'à ce nombre de secondes et renvoie dès que le statut change — moins cher que l'interrogation répétée, et plus rapide pour être informé d'une fin. La limite est de 45 secondes ; sans cela, l'appel revient immédiatement.
Réponse
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "réussi",
"created_at": "2026-09-22T04:10:00Z",
"completed_at": "2026-09-22T04:17:12Z",
"credits_used": 1792,
"chat_id": "0192f3c6-2e75-7b14-9a63-7c4e2d8f1b09",
"assets": [
{
"id": "0192f3e1-8b52-7c03-a41d-6e2f9b7c1d44",
"kind": "image",
"mime_type": "image/png",
"width": 1920,
"height": 1080,
"size_bytes": 2841233,
"url": "https://storage.googleapis.com/…",
"url_expires_at": "2026-09-22T05:17:12Z"
}
],
"error": null,
"poll_after_seconds": 60
}
}Statuts
statut | Signification | Repoller ? |
|---|---|---|
en file d'attente | accepté, pas encore démarré | oui |
en cours | le workflow s'exécute | oui |
réussie | terminé ; ressources contient la sortie | non |
échoué | arrêté ; erreur explique pourquoi | non |
needs_input | le workflow a posé une question et attend une réponse | voir ci-dessous |
expiré | jamais terminé auparavant expires_at | non |
Traitez tout statut que vous ne reconnaissez pas comme non terminal et continuez à interroger — de nouveaux peuvent apparaître sans changement de version.
credits_used correspond à ce que l'exécution a dépensé jusqu'ici, net des remboursements — présent dès la première facturation, pas seulement une fois qu'elle se termine. Une clé limitée à certains workflows considère l'exécution d'un autre workflow comme introuvable.
needs_input
Certains workflows posent une question en cours d'exécution. L'exécution attend qu'une personne dans Morphic Studio y réponde ; ouvrez chat_id pour le faire. L'exécution reprend d'elle-même une fois la réponse donnée, et expire si personne ne le fait avant expires_at.
Éléments
ressources contient seulement les actifs que le workflow déclare comme sortie — pas chaque fichier intermédiaire produit par ses étapes. Ce qui se retrouve ici est une décision prise par ses auteurs dans Studio.
| Champ de l'actif | Signification |
|---|---|
id | identifiant stable de l'actif dans Morphic ; peut être stocké sans risque |
kind | image, vidéo, audio ou document |
width, height | pixels, pour image et vidéo |
duration_seconds | pour vidéo et audio |
url | un lien de téléchargement signé et temporaire |
url_expires_at | quand ce lien cesse de fonctionner |
url expire. Téléchargez les octets dans votre propre stockage lorsque vous les recevez ; relisez l'exécution pour obtenir un nouveau lien si vous en avez besoin plus tard. Ne stockez jamais url comme s'il était permanent.
Une réussie une exécution avec un ressources tableau vide signifie que le workflow ne déclare aucune sortie finale. C'est une lacune dans l'édition du workflow, pas une erreur d'API — demandez à ses auteurs dans Studio d'indiquer la sortie de quelle étape est le livrable.