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 to act on their Runway account — create or update avatars, manage documents, trigger generations, check credit balance, etc. For writing integration code into a project, use the +integrate-* skills 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: Pair this skill with +api-reference when you need the canonical API contract. Do not use +integrate-image, +integrate-video, +integrate-audio, +integrate-characters, or +integrate-documents unless the task is to write or modify application code.

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:

1. $RUNWAY_SKILLS_DIR/skills/use-runway-api/scripts/runway-api.mjs (if the env var is set)