---
title: "Tasks · Practice Manager API · COUNT Partner API"
description: "Tasks are units of work with assignees, statuses, deadlines, and optional project links. Partner responses expose UUIDs; numeric foreign keys on the task root…"
canonical: "https://developers.getcount.com/practice-manager/reference/tasks"
source: "https://developers.getcount.com/practice-manager/reference/tasks"
---
Practice Manager API

# Tasks

Tasks are units of work with assignees, statuses, deadlines, and optional project links. Partner responses expose UUIDs; numeric foreign keys on the task root are stripped.

Last updated 2026-11-18

## Overview

The Tasks API provides full CRUD for tasks in a workspace. Create tasks with a required `type`, assign them to people, link them to projects, and filter list results with rich query parameters.

Updates use PATCH (not PUT). Create and update are JSON-only; files go through the task attachment routes, which take URLs, inline base64 content or multipart uploads. Only `firm-team` and `team-only` tasks are returned; firm-only tasks are never visible through this API, whatever `visibility` you pass.

## Key concepts

### Required type on create

Every create request must include `type` — the task type identifier, `custom` for ordinary work.

### UUID-resolvable foreign keys

Optional FK fields (`assigneeId`, `statusId`, `projectId`, and others) accept either a UUID or a workspace-scoped numeric id. Prefer UUIDs from list responses.

### Visibility

List and get return `firm-team` and `team-only` tasks only. Firm-only tasks, including INTERNAL_TASK records, cannot be read, updated or deleted through this API.

### Tags

Pass `tags` as an array of UUIDs or positive integer ids — all elements must be the same kind. On update, tags replace the full set atomically.

## The task object

Core fields returned on task records. 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.

#### Attributes

`id` uuid

Task identifier (UUID).

`name` string

Task title.

`type` string

Task type identifier, such as `custom`. Required on create.

`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 level.

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

`visibility` enum

Who can see the task. Firm-only tasks are not returned by this API.

One of: `firm-team`, `team-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`. Numbered per workspace, so not unique across workspaces.

`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 user: `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 status the task is in: `name`, `statusType`, display colors and `order`.

`projects` array

Linked projects.

`attachments` array

Files attached to the task.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "id": "22334455-6677-8899-aabb-ccddeeff0011",
  "name": "Review wireframes",
  "type": "custom",
  "description": "Review and approve wireframes before development.",
  "status": "not_started",
  "priority": "medium",
  "visibility": "firm-team",
  "deadlineDate": "2026-04-15T00:00:00.000Z",
  "startDate": null,
  "completedAt": null,
  "customId": "TODO-42",
  "budgetedMinutes": null,
  "isTimeTrackable": false,
  "totalMinutesTracked": "0",
  "creatorEntity": "client",
  "source": null,
  "assignedAt": "2026-01-15T10:30:00.000Z",
  "assignee": {
    "id": 5521,
    "firstName": "Jane",
    "lastName": "Smith",
    "avatarUrl": null
  },
  "assigner": {
    "id": 5521,
    "firstName": "Jane",
    "lastName": "Smith",
    "avatarUrl": null
  },
  "createdBy": {
    "id": 5521,
    "firstName": "Jane",
    "lastName": "Smith",
    "avatarUrl": null
  },
  "taskStatus": {
    "id": 311,
    "name": "Not Started",
    "statusType": "not_started",
    "color": "#ACB2BD",
    "order": 0
  },
  "projects": [
    {
      "name": "Website Redesign"
    }
  ],
  "attachments": [],
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}
```

Legacy filters stripped

The list filters `clients`, `openTaskOnly`, and `isForClosing` are always removed server-side on partner routes.

## Related

- [Projects API](https://developers.getcount.com/practice-manager/reference/projects)
- [People API](https://developers.getcount.com/practice-manager/reference/people)

## Endpoints

[GET List tasks `/firm-partners/workspace/tasks` Returns a paginated list of tasks.](https://developers.getcount.com/practice-manager/reference/tasks/list-tasks) [GET Get a task `/firm-partners/workspace/tasks/{uuid}` Retrieves a single task by UUID.](https://developers.getcount.com/practice-manager/reference/tasks/get-task) [POST Create a task `/firm-partners/workspace/tasks` Creates a new task.](https://developers.getcount.com/practice-manager/reference/tasks/create-task) [PATCH Update a task `/firm-partners/workspace/tasks/{uuid}` Updates an existing task. Only the fields you send are changed.](https://developers.getcount.com/practice-manager/reference/tasks/update-task) [DELETE Delete a task `/firm-partners/workspace/tasks/{uuid}` Deletes a task by UUID.](https://developers.getcount.com/practice-manager/reference/tasks/delete-task) [GET List task attachments `/firm-partners/workspace/tasks/{uuid}/attachments` Lists the files attached to a task.](https://developers.getcount.com/practice-manager/reference/tasks/list-task-attachments) [POST Add task attachments `/firm-partners/workspace/tasks/{uuid}/attachments` Adds files to a task from public URLs or inline base64 content.](https://developers.getcount.com/practice-manager/reference/tasks/add-task-attachments) [POST Upload task attachments `/firm-partners/workspace/tasks/{uuid}/attachments/upload` Adds files to a task via multipart form data.](https://developers.getcount.com/practice-manager/reference/tasks/upload-task-attachments) [DELETE Delete task attachment `/firm-partners/workspace/tasks/{uuid}/attachments/{attachmentUuid}` Removes one file from a task.](https://developers.getcount.com/practice-manager/reference/tasks/delete-task-attachment) [GET Get task attachment content `/firm-partners/workspace/tasks/{uuid}/attachments/{attachmentUuid}/content` Returns one task attachment's file, base64-encoded.](https://developers.getcount.com/practice-manager/reference/tasks/get-task-attachment-content)
