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

iduuid

Task identifier (UUID).

namestring

Task title.

typestring

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

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

One of: high, medium, low

visibilityenum

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

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

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

projectsarray

Linked projects.

attachmentsarray

Files attached to the task.

createdAtdatetime

ISO 8601 creation timestamp.

updatedAtdatetime

ISO 8601 last update timestamp.

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

Endpoints