---
title: "Run a Studio workflow · dynamic cost"
method: POST
path: "/api/v1/studio/runs"
tags: ["Studio"]
---

# Run a Studio workflow · dynamic cost

`POST /api/v1/studio/runs`

## Request

- Base URL: `https://legal.nexusquantum.legal`
- URL: `https://legal.nexusquantum.legal/api/v1/studio/runs`
- Auth: HTTP bearer

Runs a workflow (resolved by `.or(user_id, is_template)`; the run is inserted with `user_id: userId`). The INTERNAL route debits (dynamic cost by steps/size) — the v1 wrapper does NOT debit (charging parity). Thin loopback to `/api/studio/runs`. Scope: mcp | *.

## Request body

- object
  - `workflowId` string, uuid, required
  - `input` object

## Response `200`

Run result.

- object

## Other responses

- `402`: INSUFFICIENT_CREDITS — insufficient balance (the internal route charges).
- `404`: Workflow not found or not yours.

---

[API](https://skmtc.dev/nexusquantum/apis/nexus-legal-api.md) · [All operations](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/revisions/4084d8d4eb0b?raw)