---
title: "Run a workflow, paid once via x402"
method: POST
path: "/v1/workflows/{id}/run"
---

# Run a workflow, paid once via x402

`POST /v1/workflows/{id}/run`

## Request

- Base URL: `https://agents.dexl.io`
- URL: `https://agents.dexl.io/v1/workflows/{id}/run`
- Auth: API key in header `X-Payment`

Agents, models and tools chained into one step. The price is every node bounded at its worst case.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `input` string, required: The input for the first node. Reachable in later nodes as {{input}}.

## Response `200`

The run and its steps

## Other responses

- `400`: input is missing or too long. No payment was taken.
- `402`: Payment required
- `404`: No workflow with that id. No payment was taken.
- `409`: The workflow is not active, or can no longer be priced. No payment was taken.

---

[API](https://skmtc.dev/dexl/apis/dexl-agents.md) · [All operations](https://skmtc.dev/dexl/apis/dexl-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/dexl/apis/dexl-agents/revisions/e3692765c3f7?raw)