Update a firm task
/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.
Path parameters
uuiduuidrequiredFirm task UUID.
Request body
namestringTask title, 1–1000 characters.
descriptionstringTask details. Null clears.
priorityenumPriority.
One of: high, medium, low
visibilityenumVisibility.
One of: firm-team, team-only, firm-only
deadlinedateDue date (YYYY-MM-DD). Null clears.
startDatedateStart date (YYYY-MM-DD). Null clears.
customIdstringReadable reference, up to 255 characters.
typestringTask type, up to 64 characters.
assigneeUuiduuidFirm member user id to reassign the task to.
projectUuiduuidProject to link. Null unlinks. Moves the task to the project’s workspace unless `clientWorkspaceUuid` is also sent.
clientWorkspaceUuiduuidClient workspace to move the task to.
budgetedMinutesintegerTime budget in minutes, 0 or more. Null clears.
isTimeTrackablebooleanWhether 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. Troubleshoot403The 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. Troubleshoot404The 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). Troubleshoothttps://api.getcount.com/firm-partners/firm/tasks/{uuid}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());{
"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"
}
}
}