Firm TasksUpdate 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

Path parameters

uuiduuidrequired

Firm task UUID.

Request body

namestring

Task title, 1–1000 characters.

descriptionstring

Task details. Null clears.

priorityenum

Priority.

One of: high, medium, low

visibilityenum

Visibility.

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

deadlinedate

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

startDatedate

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

customIdstring

Readable reference, up to 255 characters.

typestring

Task type, up to 64 characters.

assigneeUuiduuid

Firm member user id to reassign the task to.

projectUuiduuid

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

clientWorkspaceUuiduuid

Client workspace to move the task to.

budgetedMinutesinteger

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

isTimeTrackableboolean

Whether staff can log time against the task.

Responses

200The updated firm task.
400A field fails validation, or the task belongs to a closed accounting period.
401Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. Troubleshoot
403The 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
404The task, assignee, project or client workspace is not part of the firm.
429Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). Troubleshoot
PATCHhttps://api.getcount.com/firm-partners/firm/tasks/{uuid}
Request
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
{
  "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"
    }
  }
}