---
title: "Run an RDA"
method: POST
path: "/run"
---

# Run an RDA

`POST /run`

Execute an RDA and receive the output. Cost is deducted from your wallet balance.

## Request body

- object
  - `rdaSlug` string, required — RDA identifier (slug or ID)
  - `inputs` object, required — Input values matching the RDA's input schema
  - `modelId` string — Model ID for prompt RDAs (uses default if omitted)

## Response `200`

Successful execution

- RunResult
  - `success` boolean
  - `runId` string
  - `output` string — RDA output (format varies by type)
  - `cost` number — Amount charged in USDC
  - `duration` integer — Execution time in milliseconds
  - `modelId` string
  - `usage` object
    - `prompt_tokens` integer
    - `completion_tokens` integer
    - `total_tokens` integer

## Other responses

- `400` — Invalid input
- `401` — Unauthorized
- `402` — Insufficient balance
- `404` — RDA not found

---

[API](https://skmtc.dev/xpay/apis/xpay-hub-api.md) · [All operations](https://skmtc.dev/xpay/apis/xpay-hub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xpay/xpay-hub-api/revisions/bd819de96276/schema)