Skip to main content

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.update or task-related permissions

Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token: Bearer <token>
Content-TypestringYesapplication/json

Path Parameters

ParameterTypeRequiredDescription
staffIdstringYesStaff member identifier
taskIdstringYesTask identifier

Request Body

{
"status": "completed"
}

Body Parameters

ParameterTypeRequiredDescription
statusstringYesTask 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