워크플로우 실행 시작
입력을 넣어 워크플로를 시작하고 실행 ID를 돌려받습니다.
POST {base_url}/workflow-runsruns:write 권한이 필요합니다.
요청
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",
"name": "Story 48213",
"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": "thriller"
}
}| 본문 필드 | 필수 | 의미 |
|---|---|---|
org_id | 예 | 귀하의 조직; 키의 것과 일치해야 합니다 |
project_id | 예 | 실행과 해당 자산이 배치되는 캔버스 — Studio URL의 ID, …/editor/<project_id>/canvas |
workflow_id | 예 | 실행할 워크플로 |
inputs | 예 | 각 입력의 key를 키로 하는 객체 |
idempotency_key | 권장 | 재시도를 안전하게 만듭니다 — 참조 규칙 |
workflow_version_id | 아니요 | 입력을 읽어온 버전을 고정합니다 |
webhook_id | 아니요 | 이 실행의 이벤트를 등록된 하나의 엔드포인트로 보냅니다 — 참조 웹훅 |
name | 아니요 | 실행이 이루어지는 Studio 세션의 제목으로, API: <name> 형식으로 표시됩니다. 한 줄, 최대 250자. 생략하면 워크플로 이름이 사용됩니다 |
각 입력을 전송하는 방법
accepts | 전송 | allow_multiple 사용 시 |
|---|---|---|
value | 문자열, 숫자 또는 불리언 자체 | 그것들의 배열 |
url | 공개 HTTPS 링크 하나, 문자열로 | 링크의 배열 |
option | options[].id 하나, 제공된 그대로 | ID 배열 |
응답
202 Accepted
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "queued",
"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"
}
}| 응답 필드 | 의미 |
|---|---|
id | 실행 ID입니다. 폴링하고, 자체 기록에 보관하세요 |
status | 수락 시 queued |
chat_id | 실행이 이루어지는 Studio 세션입니다. 열어서 실행을 보거나, 요청한 질문에 답하세요 |
ingested | 가져온 파일당 하나의 항목이며, 전송한 순서대로 정렬됩니다. 의도한 대로 보냈는지 확인하는 데 유용합니다 |
poll_after_seconds | 첫 번째 폴링 전까지 기다릴 시간 |
expires_at | 미완료 실행이 expired로 중단되는 시점 |
모든 링크는 가져와 검증됩니다 이전에 202. 허용되어 돌아온 실행은 파일을 이미 확보했으므로, 잘못된 링크는 10분 뒤의 실패가 아니라 즉시 400이 됩니다.