POST
Start workflows by event

Authorizations

Authorization
string
header
required

An API key minted in the console (ctd_…). Authenticates; never authorizes funds. A key carries scopes (read, wallets.write, transactions.write, events.write, webhooks.write, policy.write) and may be limited to vaults, to IP addresses, and in lifetime — see Authentication.

Headers

Idempotency-Key
string

Makes a retry safe. The same key with the same body returns the first result; with a different body (on /events/{name}: other inputs or another network), 409 idempotency_conflict. Also accepted as idempotency_key in the body. Without one, POST /transactions answers with an idempotency_key of its own, intent:<uuid>.

Maximum string length: 255

Path Parameters

name
string
required
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$

Body

application/json
network
enum<string>
required

The network the data lives on. Required wherever it appears in a request — there is no default network. One your installation does not serve: 422 network_not_served.

Available options:
mainnet,
testnet
inputs
object

The inputs the workflow declared, by key.

Response

Runs started.

event
string
required
network
enum<string>
required

The network the data lives on. Required wherever it appears in a request — there is no default network. One your installation does not serve: 422 network_not_served.

Available options:
mainnet,
testnet
runs
object[]
required