Skip to main content
POST
Test a step — kind-aware behavior (trigger samples vs action exec)

Authorizations

Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Path Parameters

uuid
string<uuid>
required
step
string<uuid>
required

Body

application/json
persist
boolean
default:true

Save the result to step.last_test and activate the step. Set false to test without committing.

data
object | null

(triggers) Manual sample payload. When set, skips auto-fetch and persists this object as test_data.

sample_uuid
string | null

(triggers) Pick a specific record from the auto-fetched list.

limit
integer
default:10

(triggers) Max samples to return.

Required range: x <= 50
input_data
object | null

(actions) Override the upstream {{stepN.…}} resolution. Useful to test with hypothetical input.

config_override
object | null

(actions) Test with a config different from step.config (does not persist).

dry_run
boolean
default:false

(actions) Force dry-run even for normally-live actions.

live
boolean
default:false

(actions) Force real execution. Bypasses the safe-list — destructive sends/writes will actually go through to the third party.

Response

Test ran

success
boolean
Example:

true

data
object