Docs / API reference /
Submit async tasks in a batch
POST https://api.answerline.dev/v1/async/task/batch
Create as many as 500 async tasks in a single request. Tasks are validated one by one, so an invalid task does not stop the others from being accepted. The response lists a result for each task.
Returns
-
successboolean required -
Set to true for every batch that was processed successfully; individual tasks inside it can still have failed.
-
summaryobject required -
Totals across the whole batch.
3 properties
-
summary.totalinteger required -
How many tasks the batch submission contained.
-
summary.succeededinteger required -
How many tasks were created without error.
-
summary.failedinteger required -
How many tasks were not created.
-
-
resultsobject[] required -
Result for each task, listed by index in the same order as the input.
Responses
- 200
- The batch was processed. See the summary and each task's result to learn which tasks succeeded or failed.
- 401
- Unauthorized - authentication failed
- 422
- Validation Error - the body of the request is empty or not a proper array
- 429
- Queue Limit Exceeded - no task in the batch is accepted, because together they do not fit in your queue. This status is also returned when the API cannot take the request right now (
SERVICE_OVERLOADED, sent withRetry-Afterand without limit headers) and when one address presented too many unknown keys (RATE_LIMIT_EXCEEDED, withRetry-After) - 500
- Internal Server Error