Create data step
Data Steps
Create data step
Create a Data Step (HTTP call) for an action or attribute.
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/jsonBody 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 createdData Step with sensitive values masked.
Errors
400 Bad Request
400 Bad Request
The body is malformed or missing a required field.
403 Forbidden
403 Forbidden
The API key does not include the
write scope required for this route.500 Internal Server Error
500 Internal Server Error
Fini failed while creating the Data Step in storage.

