---
title: "Projects · Practice Manager API · COUNT Partner API"
description: "Projects group work for a customer with a status, schedule, and associated tasks. Partner responses use UUIDs; numeric `customerId` and `statusId` fields are…"
canonical: "https://developers.getcount.com/practice-manager/reference/projects"
source: "https://developers.getcount.com/practice-manager/reference/projects"
---
Practice Manager API

# Projects

Projects group work for a customer with a status, schedule, and associated tasks. Partner responses use UUIDs; numeric `customerId` and `statusId` fields are stripped.

Last updated 2026-11-18

## Overview

The Projects API lets your integration list project statuses, create and manage projects, and list the tasks attached to a project. Projects optionally link to a customer and always carry a workspace-defined status.

Use `GET /firm-partners/workspace/projects/statuses` to discover status UUIDs before creating or filtering projects. Soft-deleted projects return 404 and are excluded from list results. Updates use PATCH (not PUT).

## Key concepts

### Status discovery

Call List project statuses first. Pass the returned UUID as `statusUuid` on create/update, or filter list with `statusUuids` (comma-separated).

### Customer linking

Pass `customerUuid` from the Customers API on create. On update, pass a UUID to set the customer, `null` or empty string to clear, or omit to leave unchanged.

### Archiving

DELETE archives the project. Archived projects are excluded from list and return 404 on retrieve.

### Project tasks

Tasks linked to a project are listed via `GET /firm-partners/workspace/projects/{uuid}/tasks` with the same sanitized task shape as the Tasks API.

## The project object

Fields returned on a project. Customer and projectStatus associations expose UUIDs.

#### Attributes

`id` uuid

Project identifier (UUID).

`name` string

Project name. Required on create.

`description` string

Free-text description.

`customId` string

Optional external reference id.

`startDate` date

Project start date (ISO).

`endDate` date

Project end date (ISO).

`customer` object

Linked customer, or null when the project is not customer-specific.

`uuid` uuid

Customer UUID.

`customer` string

Customer display name.

`projectStatus` object

Current project status.

`uuid` uuid

Status UUID.

`name` string

Status label.

`color` string

Display color.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "id": "11223344-5566-7788-99aa-bbccddeeff00",
  "name": "Website Redesign",
  "description": "Redesign the marketing website for Acme Corporation.",
  "customId": "PRJ-2026-001",
  "startDate": "2026-02-01",
  "endDate": "2026-06-30",
  "customer": {
    "uuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
    "customer": "Acme Corporation"
  },
  "projectStatus": {
    "uuid": "aabbccdd-eeff-4012-8000-001122334455",
    "name": "In Progress",
    "color": "#E48642"
  },
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}
```

Use UUID filter params

List filters accept `customerUuids` and `statusUuids` (comma-separated). Legacy numeric `customers` and `statusIds` query params are stripped server-side.

## Related

- [Customers API](https://developers.getcount.com/practice-manager/reference/customers)
- [Tasks API](https://developers.getcount.com/practice-manager/reference/tasks)
- [Time Entries API](https://developers.getcount.com/practice-manager/reference/time-entries)

## Endpoints

[GET List project statuses `/firm-partners/workspace/projects/statuses` Returns the project statuses available in the workspace.](https://developers.getcount.com/practice-manager/reference/projects/list-project-statuses) [GET List projects `/firm-partners/workspace/projects` Returns a paginated list of projects.](https://developers.getcount.com/practice-manager/reference/projects/list-projects) [POST Create a project `/firm-partners/workspace/projects` Creates a new project in the workspace.](https://developers.getcount.com/practice-manager/reference/projects/create-project) [POST Bulk create projects `/firm-partners/workspace/projects/bulk` Creates up to 100 projects in one request with partial-success semantics.](https://developers.getcount.com/practice-manager/reference/projects/bulk-create-projects) [GET List project tasks `/firm-partners/workspace/projects/{uuid}/tasks` Returns tasks attached to a project.](https://developers.getcount.com/practice-manager/reference/projects/list-project-tasks) [GET Get a project `/firm-partners/workspace/projects/{uuid}` Retrieves a single project by UUID.](https://developers.getcount.com/practice-manager/reference/projects/get-project) [PATCH Update a project `/firm-partners/workspace/projects/{uuid}` Updates an existing project. Only the fields you send are changed.](https://developers.getcount.com/practice-manager/reference/projects/update-project) [DELETE Archive a project `/firm-partners/workspace/projects/{uuid}` Archives a project, the same as Archive Project in the COUNT app.](https://developers.getcount.com/practice-manager/reference/projects/delete-project)
