task_delivery_invalid: The delivery claim is not usable
The delivery claim does not have the exact dynamo-task-delivery-v1 shape, names another task, or claims more units than the milestone is quoted at. Nothing is recorded.
A streamed meter (/payee/v1/tasks/:id/units) answers the same code when its requestRef starts with task-, or when its requestRef was already metered at another number of units. Nothing is metered. A requestRef that is not 1 to 96 printable characters, or units that are not a positive decimal digit string, answer 400 invalid_request first.
What to do
- The delivery is malformed (dynamo-task-delivery-v1: taskId, milestoneId, units up to the milestone's quote, a 32-byte SHA-256 deliverable, issuedAt).
On the wire
HTTP 409, error type state_error.
With Dynamo-Error-Detail: 1 (1.8.0 task routes):
{
"error": "state",
"reason": "task_delivery_invalid",
"detail": "…",
"errorDetail": {
"type": "state_error",
"code": "task_delivery_invalid",
"message": "…",
"param": "task",
"doc_url": "…/errors/task_delivery_invalid.md",
"fix": "the delivery is malformed (dynamo-task-delivery-v1: taskId, milestoneId, units up to the milestone's quote, a 32-byte SHA-256 deliverable, issuedAt)"
}
}
See the Task Allowance and all error codes.