---
title: "Run Play"
method: POST
path: "/api/plays/{play_id}/runs"
tags: ["plays"]
---

# Run Play

`POST /api/plays/{play_id}/runs`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/plays/{play_id}/runs`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Path parameters

- `play_id` string, required

## Request body

- PlayRunRequest
  - `idempotency_key` string, required
  - `input` object: Revision-defined JSON input, limited to 64 KiB and finite numbers.
  - `revision_id` string, required

## Response `202`

Successful Response

- PlayRunResponse
  - `created` boolean, required: True when this request admitted a new run; false when it adopted one.
  - `live_url` string, required: Tenant-scoped SSE path for durable run progress and terminal state.
  - `revision_id` string, required: Immutable revision pinned for this run.
  - `run_id` string, required: Durable Play run id.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)