Practice Manager API
Firm Tasks
The firm’s own work queue: tasks owned by the practice, for internal work or for a client, assigned to firm members and filterable across every client at once.
Last updated 2026-10-23
Overview
Firm tasks are the work items in the firm’s Practice Manager. Each belongs to the firm and sits in either the firm’s own workspace (internal work) or one client workspace (work for that client). One list call spans every client, which is what distinguishes these routes from the per-client Tasks routes under `/firm-partners/workspace/tasks`.
Reads need `tasks:read` and writes need `tasks:write`. Needs a key with access to all client workspaces. A key limited to selected client workspaces gets 403 on this route.
Key concepts
Firm workspace or client workspace
A task created without `clientWorkspaceUuid` sits in the firm’s own workspace. Pass a client workspace id (from List client workspaces) to file it under that client, or a `projectUuid` and the task goes to the project’s workspace.
Visibility
`firm-team` (the default) is visible to the firm and the client; `team-only` to the client side; `firm-only` to the firm alone. `type: "INTERNAL_TASK"` always creates a firm-only task.
Assignees are user ids
`assigneeUuid` and the assignee filters take the `user.id` from List firm members, not the membership `id`. Omit `assigneeUuid` on create and the task is assigned to the member the key acts as.
Who the key acts as
A firm API key acts as the firm’s owner (or its first admin if it has no active owner), so tasks you create are attributed to that member.
The firm task object
Fields returned on every firm task. Nested people, status and project objects carry COUNT’s internal numeric `id`, not a UUID — read them for display, not as input to other routes. Responses also carry internal fields not listed here; do not rely on them.
Attributes
iduuidFirm task UUID.
namestringTask title.
typestringTask type, such as `custom` or `INTERNAL_TASK`.
descriptionstringTask details. May be null.
statusenumStatus type of the task’s current status.
One of: not_started, in_progress, waiting_for_client, blocked, ready_for_review, done, canceled
priorityenumPriority.
One of: high, medium, low
visibilityenumWho can see the task. See Visibility below.
One of: firm-team, team-only, firm-only
deadlineDatedatetimeDue date, at midnight UTC. May be null.
startDatedatetimeStart date. May be null.
completedAtdatetimeWhen the task was completed, or null.
customIdstringReadable reference COUNT generates, such as `TODO-42` or `<PROJECT KEY>-7`. Numbered per workspace, so two clients can both have a `TODO-42`.
budgetedMinutesintegerTime budget in minutes. May be null.
isTimeTrackablebooleanWhether staff can log time against the task.
totalMinutesTrackedstringMinutes logged against the task, as a numeric string.
creatorEntityenumWhich side created the task.
One of: accounting-firm, client
sourcestring`ai_agent` for tasks an AI agent created, otherwise null.
assigneeobjectThe assigned firm member: `firstName`, `lastName`, `avatarUrl`, and an internal numeric `id`.
assignerobjectWho assigned the task. Same shape as `assignee`.
createdByobjectWho created the task. Same shape as `assignee`.
taskStatusobjectThe firm status the task is in: `name`, `statusType`, display colors and `order`.
projectsarrayLinked projects: `name` and `status` for each.
attachmentsarrayFiles attached to the task.
billobjectThe linked bill, or null.
transactionobjectThe linked transaction, or null.
teamobjectThe workspace the task sits in: `id` (workspace UUID) and `name`.
createdAtdatetimeCreation timestamp.
updatedAtdatetimeLast update timestamp.
{
"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"
}Changing a task’s project can move it to another client
On update, the task moves to `clientWorkspaceUuid` if you send one, otherwise to the workspace of the `projectUuid` you send. `clientWorkspaceUuid: null` does not detach the task from its client.Not yet available on this surface
Setting or filtering by a specific firm status, and tagging tasks, need ids that no Practice Manager route returns yet. Filter by status type with `status` instead.Related
Endpoints
/firm-partners/firm/tasksReturns a page of the firm’s tasks across every client, with filters.
/firm-partners/firm/tasks/{uuid}Retrieves one firm task.
/firm-partners/firm/tasksCreates a task in the firm’s workspace or under one of its clients.
/firm-partners/firm/tasks/{uuid}Updates the fields you send and leaves the rest unchanged.
/firm-partners/firm/tasks/{uuid}Deletes a firm task, with its attachments, tags and recurrence.
