projects

List projects

List projects in the organization.

Returns a paginated list of projects. By default, only active (non-archived) projects are returned. Set include_archived=true to include archived projects.

Pass include=counts to populate related_counts on every project in the page. The counts for the whole page cost one extra query regardless of page_size.

Pass include=members to populate members on every project in the page. Also one extra query for the whole page, but unlike counts the response grows with the rosters it carries.

Pass updated_since to poll for change instead of reading the whole organization. It answers "what changed", not "what changed to what": the response carries each project's current state, so a caller tracking a field — an archive flip, a rename, a Unanet custom field — compares it against what it last saw. Two properties make that safe to build on:

  • It also reports creations. A project created inside the window has no updated_at yet, and is matched on created_at instead. One cursor therefore covers both, and a caller needs no second poll for new projects.
  • The bound is inclusive and the order is oldest change first. Store the newest updated_at (or created_at) you were served and pass it back; you may be re-served that one row, and you will not miss one that shares its timestamp across a page boundary.

It does not report deletions — a deleted project is simply absent from later responses. Archiving is not a deletion: an archived project is still listed under include_archived=true, with is_active: false.

get/projects

Request

  • Base URL: https://api.cogram.com/v1
  • URL: https://api.cogram.com/v1/projects
  • Auth: HTTP bearer

Query parameters

includeProjectIncludeV1[]

Optional response sections. counts populates related_counts; members populates members. Omitted sections come back as null. Repeat the param (include=counts&include=members) or comma-separate the values (include=counts,members) — both work.

pageinteger

Page number (1-indexed).

page_sizeinteger
include_archivedboolean
updated_sincestring date-time nullable

Only return projects created or changed at or after this instant, oldest change first. Must include a UTC offset (e.g. 2026-08-17T18:03:11Z). Compares against updated_at, falling back to created_at for a project that has never been updated.

Response

Successful Response

totalinteger required

Total matches across all pages, not just this page.

pageinteger required
page_sizeinteger required

Changes

No recorded changes to this operation across all 2 revisions of this API.