Immutable solution version
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.
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.
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 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Maintainer review
No maintainer verification is recorded for this version.
A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.
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>