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

iduuid

Firm task UUID.

namestring

Task title.

typestring

Task type, such as `custom` or `INTERNAL_TASK`.

descriptionstring

Task details. May be null.

statusenum

Status type of the task’s current status.

One of: not_started, in_progress, waiting_for_client, blocked, ready_for_review, done, canceled

priorityenum

Priority.

One of: high, medium, low

visibilityenum

Who can see the task. See Visibility below.

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

deadlineDatedatetime

Due date, at midnight UTC. May be null.

startDatedatetime

Start date. May be null.

completedAtdatetime

When the task was completed, or null.

customIdstring

Readable reference COUNT generates, such as `TODO-42` or `<PROJECT KEY>-7`. Numbered per workspace, so two clients can both have a `TODO-42`.

budgetedMinutesinteger

Time budget in minutes. May be null.

isTimeTrackableboolean

Whether staff can log time against the task.

totalMinutesTrackedstring

Minutes logged against the task, as a numeric string.

creatorEntityenum

Which side created the task.

One of: accounting-firm, client

sourcestring

`ai_agent` for tasks an AI agent created, otherwise null.

assigneeobject

The assigned firm member: `firstName`, `lastName`, `avatarUrl`, and an internal numeric `id`.

assignerobject

Who assigned the task. Same shape as `assignee`.

createdByobject

Who created the task. Same shape as `assignee`.

taskStatusobject

The firm status the task is in: `name`, `statusType`, display colors and `order`.

projectsarray

Linked projects: `name` and `status` for each.

attachmentsarray

Files attached to the task.

billobject

The linked bill, or null.

transactionobject

The linked transaction, or null.

teamobject

The workspace the task sits in: `id` (workspace UUID) and `name`.

createdAtdatetime

Creation timestamp.

updatedAtdatetime

Last update timestamp.

Example
{
  "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.

Endpoints