Tasks API
Read and update the tasks that make up a trade agent's queue.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/tasks | List tasks assigned to the authenticated agent. |
| GET | /v1/tasks/:id | Get a single task by ID. |
| PATCH | /v1/tasks/:id | Update a task’s status (approve, reject, complete). |
The Task Object
Task object
{
"id": "tsk_9e21ab",
"orderId": "ord_51c9a2",
"assignedAgentId": "usr_77c1d4",
"type": "approval",
"status": "open",
"dueAt": "2026-02-03T17:00:00Z"
}status is one of open, approved, rejected, or completed.
Complete a Task
Request
curl -X PATCH https://api.baalvion.com/v1/tasks/tsk_9e21ab \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "approved" }'Trade agent accounts only
Tasks are only assignable to and actionable by trade agent accounts, mirroring Trade Agent dashboard workflows.