Skip to main content
POST
Create data step
Creates a Data Step: one HTTP call belonging to an action or attribute. Steps run in stepNumber order, each feeding its extracted output into the next.

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
required
Step name.
string
required
Request URL. Supports {{placeholder}} interpolation from inputs and earlier steps.
string
required
HTTP verb, for example GET, POST, PUT, PATCH, or DELETE.
string
ID of the action or attribute this step belongs to. Set it so the step runs as part of that chain.
number
Position of the step in the chain. Steps run in ascending order.
object
Request headers. To store a value as sensitive, send { "hide": true, "value": "<secret>" }. See Sensitive values and masking.
object
Request body, with the same masking support as headers.
ResponseMapping
Map of output keys to response paths. See ResponseMapping.
string
Optional explicit UUID for the new step.

Response

Returns the created Data Step with sensitive values masked.

Errors

The body is malformed or missing a required field.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.
Fini failed while creating the Data Step in storage.