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
iduuidTask identifier (UUID).
namestringTask title.
typestringTask type identifier, such as `custom`. Required on create.
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 level.
One of: high, medium, low
visibilityenumWho can see the task. Firm-only tasks are not returned by this API.
One of: firm-team, team-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`. Numbered per workspace, so not unique across workspaces.
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 user: `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 status the task is in: `name`, `statusType`, display colors and `order`.
projectsarrayLinked projects.
attachmentsarrayFiles attached to the task.
createdAtdatetimeISO 8601 creation timestamp.
updatedAtdatetimeISO 8601 last update timestamp.
{
"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
Endpoints
/firm-partners/workspace/tasksReturns a paginated list of tasks.
/firm-partners/workspace/tasks/{uuid}Retrieves a single task by UUID.
/firm-partners/workspace/tasksCreates a new task.
/firm-partners/workspace/tasks/{uuid}Updates an existing task. Only the fields you send are changed.
/firm-partners/workspace/tasks/{uuid}Deletes a task by UUID.
/firm-partners/workspace/tasks/{uuid}/attachmentsLists the files attached to a task.
/firm-partners/workspace/tasks/{uuid}/attachmentsAdds files to a task from public URLs or inline base64 content.
/firm-partners/workspace/tasks/{uuid}/attachments/uploadAdds files to a task via multipart form data.
/firm-partners/workspace/tasks/{uuid}/attachments/{attachmentUuid}Removes one file from a task.
/firm-partners/workspace/tasks/{uuid}/attachments/{attachmentUuid}/contentReturns one task attachment's file, base64-encoded.
