- **POST** `/api/tasks` - **In:** ```json { "requestId": "req-abc", "assigneeId": "uuid-1234", "resourceAllocations": [{ "resourceId": "res-001", "quantity": 100 }] } ``` - **Out:** ```json { "taskId": "task-xyz", "createdAt": "2025-06-22T14:35:00Z" } ``` - _Purpose:_ Create a task linking request, assignee, and resources ([designgurus.io][1]). - **GET** `/api/tasks` - **Out:** ```json [ { "taskId": "task-xyz", "requestId": "req-abc", "status": "pending", "createdAt": "2025-06-22T14:35:00Z" }, … ] ``` - _Purpose:_ Return all tasks ([getambassador.io][8]). - **GET** `/api/tasks/:taskId` - **Out:** ```json { "taskId": "task-xyz", "requestId": "req-abc", "status": "in_progress", "notes": "Bridge is unstable", "attachments": [{ "type": "image", "url": "https://…" }], "assignedResponder": "uuid-1234", "createdAt": "2025-06-22T14:35:00Z" } ``` - _Purpose:_ Fetch task detail with media-rich reporting ([stackoverflow.com][9]). - **PUT** `/api/tasks/:taskId` - **In:** ```json { "status": "completed", "notes": "Delivered supplies safely.", "attachments": [{ "type": "image", "url": "https://…" }] } ``` - **Out:** ```json { "taskId": "task-xyz", "updatedAt": "2025-06-22T14:40:00Z" } ``` - _Purpose:_ Update status, add notes/media ([stackoverflow.com][9]).
POST
/api/tasksIn:
{ "requestId": "req-abc", "assigneeId": "uuid-1234", "resourceAllocations": [{ "resourceId": "res-001", "quantity": 100 }] }Out:
{ "taskId": "task-xyz", "createdAt": "2025-06-22T14:35:00Z" }Purpose: Create a task linking request, assignee, and resources ([designgurus.io][1]).
GET
/api/tasksOut:
[ { "taskId": "task-xyz", "requestId": "req-abc", "status": "pending", "createdAt": "2025-06-22T14:35:00Z" }, … ]Purpose: Return all tasks ([getambassador.io][8]).
GET
/api/tasks/:taskIdOut:
{ "taskId": "task-xyz", "requestId": "req-abc", "status": "in_progress", "notes": "Bridge is unstable", "attachments": [{ "type": "image", "url": "https://…" }], "assignedResponder": "uuid-1234", "createdAt": "2025-06-22T14:35:00Z" }Purpose: Fetch task detail with media-rich reporting ([stackoverflow.com][9]).
PUT
/api/tasks/:taskIdIn:
{ "status": "completed", "notes": "Delivered supplies safely.", "attachments": [{ "type": "image", "url": "https://…" }] }Out:
{ "taskId": "task-xyz", "updatedAt": "2025-06-22T14:40:00Z" }Purpose: Update status, add notes/media ([stackoverflow.com][9]).