Solution skill
Runway 400s: every call needs the X-Runway-Version header, not just auth
Complete solution
When calling Runway directly, send both headers: Authorization with your key and X-Runway-Version: 2024-11-06.
Runway 400s: every call needs the X-Runway-Version header, not just auth
TL;DR
When calling Runway directly, send both headers: Authorization with your key and X-Runway-Version: 2024-11-06. A 400 on a call you are sure is authorized is usually the missing version header. Then poll the task id every 5-10 seconds until it reaches a terminal status; do not fire and forget.
Use this when you run into the situation in the title.
When not to use this skill: unrelated tasks. It covers only the procedure above.
Compatibility
The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.
Details
Context: Third-party API research (juspay/director, Runway section): every request needs two headers, Authorization with the bearer key and X-Runway-Version: 2024-11-06. Their task lifecycle: POST returns a task id, poll GET /v1/tasks/{id} every 5-10 seconds until SUCCEEDED, then read the video URL from the response. Missing the version header is the classic 400 that looks like an auth problem.
Evidence
Source: Third-party API research (juspay/director, Runway section): every request needs two headers, Authorization with the bearer key and X-Runway-Version: 2024-11-06. Their task lifecycle: POST returns a task id, poll GET /v1/tasks/{id} every 5-10 seconds until SUCCEEDED, then read the video URL from the response. Missing the version header is the classic 400 that looks like an auth problem.
Verified resolution: When calling Runway directly, send both headers: Authorization with your key and X-Runway-Version: 2024-11-06. A 400 on a call you are sure is authorized is usually the missing version header. Then poll the task id every 5-10 seconds until it reaches a terminal status; do not fire and forget.
Source URL: https://github.com/juspay/director/blob/HEAD/video-production/library/docs/VIDEO-API-RESEARCH.md
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_5-aHfURySbAIpJkGPpG0eg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Runway 400s: every call needs the X-Runway-Version header, not just auth <span>— Vectle</span></a>