---
title: "Update a firm task · Firm Tasks · Practice Manager API · COUNT Partner API"
description: "Updates the fields you send and leaves the rest unchanged. PATCH /firm-partners/firm/tasks/{uuid}"
canonical: "https://developers.getcount.com/practice-manager/reference/firm-tasks/update-firm-task"
source: "https://developers.getcount.com/practice-manager/reference/firm-tasks/update-firm-task"
---
[Firm Tasks](https://developers.getcount.com/practice-manager/reference/firm-tasks) / Update a firm task

# Update a firm task

PATCH `/firm-partners/firm/tasks/{uuid}`

Updates the fields you send and leaves the rest unchanged.

Unknown fields are ignored. An unparseable `startDate` or `deadlineDate` clears the date rather than failing. `assigneeUuid: null` leaves the assignee unchanged.

HMAC signature only

[Firm, clients & members](https://developers.getcount.com/practice-manager/reference/firm) [Firm projects](https://developers.getcount.com/practice-manager/reference/firm-projects) [Firm time entries](https://developers.getcount.com/practice-manager/reference/firm-time-entries)

#### Path parameters

`uuid` uuid required

Firm task UUID.

#### Request body

`name` string

Task title, 1–1000 characters.

`description` string

Task details. Null clears.

`priority` enum

Priority.

One of: `high`, `medium`, `low`

`visibility` enum

Visibility.

One of: `firm-team`, `team-only`, `firm-only`

`deadline` date

Due date (YYYY-MM-DD). Null clears.

`startDate` date

Start date (YYYY-MM-DD). Null clears.

`customId` string

Readable reference, up to 255 characters.

`type` string

Task type, up to 64 characters.

`assigneeUuid` uuid

Firm member user id to reassign the task to.

`projectUuid` uuid

Project to link. Null unlinks. Moves the task to the project’s workspace unless `clientWorkspaceUuid` is also sent.

`clientWorkspaceUuid` uuid

Client workspace to move the task to.

`budgetedMinutes` integer

Time budget in minutes, 0 or more. Null clears.

`isTimeTrackable` boolean

Whether staff can log time against the task.

#### Responses

`200` The updated firm task.

`400` A field fails validation, or the task belongs to a closed accounting period.

`401` Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`403` The API key is inactive, its scope does not cover this route, or it is limited to selected client workspaces and the route is firm-wide. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`404` The task, assignee, project or client workspace is not part of the firm.

`429` Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

[Previous POST Create a firm task](https://developers.getcount.com/practice-manager/reference/firm-tasks/create-firm-task) [Next DELETE Delete a firm task](https://developers.getcount.com/practice-manager/reference/firm-tasks/delete-firm-task)

PATCH `https://api.getcount.com/firm-partners/firm/tasks/{uuid}`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;

const method = 'PATCH';
const signingPath = '/firm/tasks/3f4a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "priority": "medium",
  "deadline": "2026-11-07",
  "assigneeUuid": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f"
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/firm-partners/firm/tasks/3f4a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
  },
  body: bodyString,
});

console.log(await response.json());
```

Response · 200

```json
{
  "status": "success",
  "message": "Firm task updated successfully",
  "data": {
    "task": {
      "id": "3f4a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c",
      "name": "Q3 sales tax filing",
      "type": "custom",
      "description": "File the California return for Q3.",
      "status": "not_started",
      "priority": "high",
      "visibility": "firm-team",
      "deadlineDate": "2026-10-31T00:00:00.000Z",
      "startDate": null,
      "completedAt": null,
      "customId": "TODO-42",
      "budgetedMinutes": 90,
      "isTimeTrackable": true,
      "totalMinutesTracked": "0",
      "creatorEntity": "accounting-firm",
      "source": null,
      "isFromPeriodClose": false,
      "isFromRecurringSeries": false,
      "isRecurringSourceTask": false,
      "assignedAt": "2026-10-21T10:04:05.000Z",
      "assignee": {
        "id": 5521,
        "firstName": "Dana",
        "lastName": "Okafor",
        "avatarUrl": null
      },
      "assigner": {
        "id": 5510,
        "firstName": "Sam",
        "lastName": "Rivera",
        "avatarUrl": null
      },
      "createdBy": {
        "id": 5510,
        "firstName": "Sam",
        "lastName": "Rivera",
        "avatarUrl": null
      },
      "taskStatus": {
        "id": 311,
        "name": "Not Started",
        "statusType": "not_started",
        "color": "#ACB2BD",
        "order": 0
      },
      "projects": [],
      "team": {
        "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
        "name": "Harbor Coffee Co."
      },
      "createdAt": "2026-10-21T10:04:05.000Z",
      "updatedAt": "2026-10-21T10:04:05.000Z"
    }
  }
}
```
