twprojects-list_project_updates
List project updates: the Markdown text on a project's dashboard and the health it reports, newest first. Filter by project, health, or date; fetch history with active_only=false.
Instructions
List project updates: the Markdown text on a project's dashboard and the health it reports. Nothing else returns either — a project row carries no health, and the activity log holds a preview of the text, not the text. Newest first. Only each project's current update is returned unless active_only is false, so an unfiltered call is not the whole history. Rows carry text (Markdown, in full, emoji codes already converted to characters), health (0 not set, 1 bad, 2 ok, 3 good), healthLabel (the name this installation gives that rating — read it, never build one from health) and color (hex, empty when the health is not set). The author and the project are bare IDs, sideloaded under included when verbose is true. Keep a response small with fields and page_size; verbose=false drops the text and returns the ratings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination of results (1-based). | |
| fields | No | The attributes to return for each project update, from the listed names. | |
| verbose | No | If false, returns id + name only — useful when scanning many results. | |
| order_by | No | The field to sort the project updates by. Omit to keep the ordering the API applies by default. | |
| page_size | No | Number of results per page for pagination (1-500). | |
| count_only | No | If true, return only {"count": N}: the exact number of matching project updates, no rows — use for "how many". Ignores page, page_size, verbose, fields. | |
| order_mode | No | The direction to sort the results in. | |
| active_only | No | If true (the default), return only each project's current update. Set it to false to read the update history, which returns every past update in full. | |
| project_ids | No | Only return the updates of these projects. Naming any project makes the endpoint ignore every other project filter, including project_healths and include_archived. | |
| show_deleted | No | If true, return deleted updates alongside the live ones; excluded by default. | |
| created_after | No | Only include updates posted at or after this moment; the boundary itself matches. Accepts an RFC 3339 timestamp (2026-08-03T14:30:00Z) or a plain YYYY-MM-DD date (2026-08-03), which covers that whole day in UTC. | |
| updated_after | No | Only include updates last edited strictly after this moment; the boundary itself does not match. Accepts an RFC 3339 timestamp (2026-08-03T14:30:00Z) or a plain YYYY-MM-DD date (2026-08-03), which covers that whole day in UTC. | |
| project_healths | No | Only return the updates reporting these health ratings, matching any of the values given. "not_set" matches an update that rates nothing. Ignored when project_ids is set. | |
| include_archived | No | If true, return the updates of archived projects alongside those of the active ones; excluded by default. Ignored when project_ids is set. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| count | No | Exact number of matches across every page. Returned instead of the rows when count_only. | |
| included | No | ||
| projectUpdates | No |