Select which response parameters from the API will be available in your pipeline. You
can map API response fields to new or existing pipeline fields.
Limited Availability: ^ This
feature is currently available only in select workspaces and might be subject to
change before general availability.
You must have an API endpoint configured with input parameters. See Configure API input parameters for instructions.
Output configuration allows you to select which fields from the API response will be
available in your pipeline. You can create new fields or overwrite existing pipeline
fields with the API response data. The available response fields depend on which
parameters were exposed when you configured the API endpoint.
-
Navigate to the output configuration section for your API endpoint.
-
Review the list of available response parameters. Each parameter shows:
-
Select properties: Checkbox to include the
parameter
-
Type: The data type of the response parameter
-
New/Existing Field Name: Where you specify the
field name in your pipeline
-
Select the response parameters you want to include in your pipeline by checking
the checkbox next to each parameter.
-
For each selected parameter, specify the field name:
-
To create a new field: The default field name is
automatically populated from the API response parameter name. You can
change this to a more meaningful name.
-
To overwrite an existing field: Select an
existing pipeline field from the drop-down instead of using a new field
name.
-
For array parameters in the response, configure multiple output fields as
needed. Array objects in JSON responses can be added multiple times. For
example, if your API returns multiple address sets, you can configure separate
output fields for each address set.
- Select the array parameter to include it in the output.
- The first set of array fields is created with the default name.
- To add additional sets, click Add Array Set.
- For subsequent sets, the field names are automatically appended with a
count number (for example, "address_2", "address_3") to avoid duplicate
names. You can change these names as needed.
-
If you want to overwrite an existing pipeline field with API response data,
select that field from the dropdown.
-
Verify that all field names are unique. If you manually enter a name that
already exists in the pipeline, you will be prompted to change it.
Note: Both the new field and the existing field with
the same name will be highlighted to help you identify the
conflict.
-
Click Save to save your output configuration.
Your output parameters are now configured. The API response
data will be available in your pipeline using the field names you specified. Your API
endpoint is now fully configured and ready to use in your pipeline. You can now use the
API Call in your workflow to retrieve or send data to the external API.