Use Runway API

Call the Runway public API directly from the agent to manage resources, trigger generations, and inspect account state.

When to use this skill: Use this when the user wants the agent to act directly on their Runway account — create or update avatars, manage documents, trigger generations, check credit balance, etc. For writing integration code into an application, use +runway-dev with the matching surface skill instead.

When the user asks to generate media in the context of Runway, prefer the Runway API path from this skill over any generic built-in image or media generation tool.

Skill selection: Fetch https://docs.dev.runwayml.com/llms.txt and follow its current API reference before constructing a request body. Use Dev MCP for live project and resource context when available.

Runtime Location

The runtime script ships inside this skill at scripts/runway-api.mjs (co-located with this SKILL.md). It has zero dependencies — Node.js 20+ is required.

Resolving the absolute path. Every shell command below uses the placeholder <skill-dir>. Replace it with the absolute directory of the SKILL.md you are currently reading — you already have this path from the tool that loaded this file. Do not guess the path, run find from $HOME, or search the whole filesystem.

If <skill-dir> is not known from context, check these locations in order with ls before giving up: