Skip to main content
POST
Test data step
Runs a single HTTP call and returns the raw response, without persisting anything. Pass a saved step’s id to test it as stored, or send the request fields inline to try a call before saving.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
string
required
application/json

Body parameters

string
Optional saved Data Step ID. When set, the stored URL, method, headers, and body are used, with any inline fields below overriding them. Stored secrets are resolved for the call.
string
Request URL. Required when id is omitted.
string
HTTP verb. Required when id is omitted.
object
Optional request headers.
object
Optional request body.
object
Optional values used to resolve {{placeholder}} tokens in the URL, headers, and body.

Response

Returns a Data Step test-run result: success, statusCode, responseBody, and error when the call failed.

Errors

The body is malformed, or requestUrl / requestMethod is missing when no id is provided.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.