> ## Documentation Index
> Fetch the complete documentation index at: https://mako-docs.devinagiffy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Task

> Update a task's properties or status

<Note>This endpoint requires authentication.</Note>

## Path Parameters

<ParamField path="id" type="string" required>
  Task UUID
</ParamField>

## Request

All fields are optional. Only include fields you want to update.

<ParamField body="title" type="string">
  New title (1-200 characters)
</ParamField>

<ParamField body="description" type="string">
  New description (max 2000 characters)
</ParamField>

<ParamField body="priority" type="integer">
  New priority (1-5)
</ParamField>

<ParamField body="status" type="string">
  New status: `open`, `in_progress`, `completed`, `cancelled`
</ParamField>

<ParamField body="dueDate" type="string">
  New due date in ISO 8601 format
</ParamField>

## Response

Returns the updated task.

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH "https://api.hitler.app/api/tasks/task-uuid-123" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "status": "completed"
    }'
  ```

  ```typescript TypeScript theme={null}
  const task = await api.updateTask("task-uuid-123", {
    status: "completed",
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "task-uuid-123",
    "title": "Review Q4 budget proposal",
    "description": null,
    "priority": 2,
    "status": "completed",
    "dueDate": "2024-01-20T17:00:00.000Z",
    "userId": "user-uuid",
    "organizationId": "org-uuid",
    "createdAt": "2024-01-15T10:35:00.000Z",
    "updatedAt": "2024-01-18T14:22:00.000Z"
  }
  ```

  ```json 404 theme={null}
  {
    "statusCode": 404,
    "message": "Task not found",
    "error": "Not Found"
  }
  ```
</ResponseExample>