Update Task Status (v1)
Method + Path
PATCH /v1/workspace/staff/:staffId/tasks/:taskId
Actual backend path: /v1/workspace/staff/:staffId/tasks/:taskId
Description
Update only the status of a task. This is a convenience endpoint for quick status updates.
Authentication
Required - JWT token in Authorization header
Required Permissions:
staff.updateor task-related permissions
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token: Bearer <token> |
Content-Type | string | Yes | application/json |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
staffId | string | Yes | Staff member identifier |
taskId | string | Yes | Task identifier |
Request Body
{
"status": "completed"
}
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Task status. Valid values: pending, in-progress, blocked, completed |
Response (200)
{
"task": {
"id": "507f1f77bcf86cd799439011",
"status": "completed",
"updatedAt": "2024-01-15T11:00:00Z"
}
}
Common Errors
- 400 Bad Request: Invalid request body
- 401 Unauthorized: Missing or invalid authentication token
- 403 Forbidden: Insufficient permissions
- 404 Not Found: Task or staff member not found
- 422 Unprocessable Entity: Validation errors
- 500 Internal Server Error: Server error