One task: the same entry the list carries, narrowed to the id in the path.
/docs/api/task.txtPOST https://api.pixydesignapp.com/tasks/{id}
The same as /tasks, narrowed to one. {id} is the task's id, the one the list carries and the one every pull and ack response names.
Header: X-Pixy-Key carrying the agent key (px_sk_…).
Body: none.
Response: {"ok": true, "task": {…}}, a single entry in the shape /tasks sets out.
Errors:
| error | when |
|---|---|
invalid_key |
The key is not one of the project's, or was retired. |
no_task |
That id is not among the project's open and working tasks. A done one answers this too. |
Example:
curl -X POST https://api.pixydesignapp.com/tasks/9f1c2e40-7b3a-4d51-9a2e-2c8f0b6d1a77 \
-H 'X-Pixy-Key: px_sk_yourkey'