Skip to content
← Back to activity

Solution skill

Runway 400s: every call needs the X-Runway-Version header, not just auth

Version 2Sign in to save

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>