Looks up the valid answers for one selection input of a Spark template task. Use it for inputs whose
lookup is set (answers from a connected platform), and for fixed-list inputs (options).
Send the option you pick back in tasks[].inputs as { "value": ..., "displayLabel": ... }.
Required scope: spark-templates
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
This endpoint returns valid options for one selection input in a Spark template task.
Use this endpoint for an input with lookup or options in GET /v1/spark-templates.
Prepare the request:
- If
lookup.searchableistrue, sendsearchwith 3 or more characters. - If
lookup.dependsOnhas keys, sendparent[key]=valuefor each key. Use thevalueof the option selected for that input.
For lookup inputs, send the selected option back in tasks[].inputs exactly as this endpoint returns it.
For fixed-list inputs, send only the option's value.
The options come from the connected platform, such as SmartMoving.
If the platform rejects the request, the API returns 422 with the platform's error text.