Validates the inputs for running a Spark template: the task inputs, and that the platforms its tasks need are
connected. Nothing is run. On success, send the returned validationToken when running the Spark (POST
/v1/conversations/{id}/sparks or /v1/projects/{id}/sparks): it carries these inputs, so the run does not validate
them again. The token is valid for 24 hours, and only until the Spark template changes.
Required scope: sparks.write
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
This endpoint validates the task inputs for a Spark template.
It also checks that the platforms for the tasks are connected.
This endpoint does not start a Spark run.
If the inputs are valid, the response contains a validation token in validationToken.
Send this validation token in POST /v1/conversations/{conversationId}/sparks or POST /v1/projects/{projectId}/sparks.
The validation token is valid for 24 hours.
It becomes invalid earlier if the Spark template changes.
While the validation token is valid, you can send it in more than one create call.
Each call starts a new Spark run with the same Spark template and inputs.
If an input is invalid, the API returns 422.
The errors.tasks[].inputs object gives the errors for each input key.