Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Runway

Scalekit connector
Open markdown

The Runway connector lets your AI agent act in each user's Runway account. Each user connects their own Runway access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 27 tools.

Tools
27
What they doRead · write · destructive
8 · 17 · 28 read17 write2 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Runway connection

    In AgentKit > Connections, create a Runway connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'runway'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Runway:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'runway_organization_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Runway credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • runway_organization_getGet the API organization's credit balance, usage tier and rate limits.Read-only

    Get Organization

    Get the API organization's credit balance, usage tier and rate limits. Returns creditBalance, tier (maxMonthlyCreditSpend and per-model limits) and usage (per-model daily generations). Use this to check credits before starting jobs. Use runway_organization_usage_get for credit usage by day and model.

    Inputs

    This tool takes no inputs.

  • runway_organization_usage_getGet credit usage for the organization broken down by day and model, for up to 90 days.Read-only

    Get Credit Usage

    Get credit usage for the organization broken down by day and model, for up to 90 days. Returns results (each date with used credits per model) and the list of models. Use this to report spend. Use runway_organization_get for the current balance.

    Inputs

    beforeDatestring
    Day after the last day to include (exclusive), YYYY-MM-DD. Default: today. Example: 2026-11-15
    startDatestring
    First day to include, YYYY-MM-DD. Default: 30 days before beforeDate. Example: 2026-10-15
  • runway_task_getGet the status and output of a Runway generation task.Read-only

    Get Task

    Get the status and output of a Runway generation task. Returns id, status (PENDING, THROTTLED, RUNNING, SUCCEEDED, FAILED or CANCELLED), createdAt, progress, failure details, and output URLs when it succeeded. Output URLs expire, so download them soon. Use this after any runway_*_create tool to wait for the result. Poll no more than every 5 seconds.

    Inputs

    idstringrequired
    Task ID returned by any Runway generation tool. Example: 17f20503-6c24-4c16-946b-35dbbce2af2f
  • runway_voice_getGet one custom voice by ID.Read-only

    Get Voice

    Get one custom voice by ID. Returns id, name, description, status, createdAt and a preview URL when available. Use this to check whether a new voice is ready. Use runway_voices_list to find IDs.

    Inputs

    idstringrequired
    Custom voice ID. Get it from runway_voices_list or runway_voice_create. Example: 6f4d5f4a-2b1c-4a39-9b55-2c9d0e9a8f31
  • runway_voices_listList the organization's custom voices.Read-only

    List Voices

    List the organization's custom voices. Returns data (voices with id, name, description, status and createdAt) and nextCursor. Use this to find a custom voice ID for runway_text_to_speech_create. Preset voices are not listed; pass them by presetId.

    Inputs

    cursorstring
    Cursor from the previous response, to get the next page. Example: eyJpZCI6IjZmNGQ1ZjRhIn0
    limitinteger
    Voices per page, 1 to 100. Default: 50. Example: 50default 50
  • runway_workflow_getGet a published workflow, including its graph of nodes.Read-only

    Get Workflow

    Get a published workflow, including its graph of nodes. Returns id, name, description and the graph with node IDs and their outputs. Use this to find the node IDs and output keys to override in runway_workflow_run.

    Inputs

    idstringrequired
    Published workflow ID. Get it from runway_workflows_list or copy it from the Runway developer portal. Example: 0d6c1d1f-7b0a-4b8b-8c41-9a3c5d2e7f10
  • runway_workflow_invocation_getGet the status and outputs of a workflow run.Read-only

    Get Workflow Invocation

    Get the status and outputs of a workflow run. Returns id, status, progress, failure details and the output of each node when finished. Use this after runway_workflow_run to wait for the result.

    Inputs

    idstringrequired
    Workflow invocation ID returned by runway_workflow_run. Example: 9b2f3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
  • runway_workflows_listList the published workflows the organization can run through the API.Read-only

    List Workflows

    List the published workflows the organization can run through the API. Returns workflows with id, name, description and version details. Use this to find a workflow ID for runway_workflow_run.

    Inputs

    This tool takes no inputs.