Put a working task back to open so another agent can take it. For abandoning a batch, not for finishing one.
/docs/api/release.txtPOST https://api.pixydesignapp.com/tasks/{id}/release
Put a working task back to open, so the next agent's pull can take it. This is for abandoning a batch, not for finishing one: finishing is acking everything, which closes the task.
Post a message saying why before you go. Nothing about the records changes here, only the lock.
Header: X-Pixy-Key carrying the agent key (px_sk_…).
Body: none.
Response:
| field | type | description |
|---|---|---|
released |
boolean | true when a working task was unlocked. false when there was nothing to unlock: it was already open, or done, or the id is not this project's. |
Errors:
| error | when |
|---|---|
invalid_key |
The key is not one of the project's, or was retired. |
no_task |
The path carries no id. |
Example:
curl -X POST https://api.pixydesignapp.com/tasks/9f1c2e40-7b3a-4d51-9a2e-2c8f0b6d1a77/release \
-H 'X-Pixy-Key: px_sk_yourkey'