---
title: "Firm Tasks · Practice Manager API · COUNT Partner API"
description: "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."
canonical: "https://developers.getcount.com/practice-manager/reference/firm-tasks"
source: "https://developers.getcount.com/practice-manager/reference/firm-tasks"
---
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

`id` uuid

Firm task UUID.

`name` string

Task title.

`type` string

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

`description` string

Task details. May be null.

`status` enum

Status type of the task’s current status.

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

`priority` enum

Priority.

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

`visibility` enum

Who can see the task. See Visibility below.

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

`deadlineDate` datetime

Due date, at midnight UTC. May be null.

`startDate` datetime

Start date. May be null.

`completedAt` datetime

When the task was completed, or null.

`customId` string

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

`budgetedMinutes` integer

Time budget in minutes. May be null.

`isTimeTrackable` boolean

Whether staff can log time against the task.

`totalMinutesTracked` string

Minutes logged against the task, as a numeric string.

`creatorEntity` enum

Which side created the task.

One of: `accounting-firm`, `client`

`source` string

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

`assignee` object

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

`assigner` object

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

`createdBy` object

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

`taskStatus` object

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

`projects` array

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

`attachments` array

Files attached to the task.

`bill` object

The linked bill, or null.

`transaction` object

The linked transaction, or null.

`team` object

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

`createdAt` datetime

Creation timestamp.

`updatedAt` datetime

Last update timestamp.

Example

```json
{
  "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

- [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)

## Endpoints

[GET List firm tasks `/firm-partners/firm/tasks` Returns a page of the firm’s tasks across every client, with filters.](https://developers.getcount.com/practice-manager/reference/firm-tasks/list-firm-tasks) [GET Get a firm task `/firm-partners/firm/tasks/{uuid}` Retrieves one firm task.](https://developers.getcount.com/practice-manager/reference/firm-tasks/get-firm-task) [POST Create a firm task `/firm-partners/firm/tasks` Creates a task in the firm’s workspace or under one of its clients.](https://developers.getcount.com/practice-manager/reference/firm-tasks/create-firm-task) [PATCH Update a firm task `/firm-partners/firm/tasks/{uuid}` Updates the fields you send and leaves the rest unchanged.](https://developers.getcount.com/practice-manager/reference/firm-tasks/update-firm-task) [DELETE Delete a firm task `/firm-partners/firm/tasks/{uuid}` Deletes a firm task, with its attachments, tags and recurrence.](https://developers.getcount.com/practice-manager/reference/firm-tasks/delete-firm-task)
