List project updates

Returns the list of published updates for a project owned by the authenticated user, newest first.

GET /api/v1/projects/{id}/updates

Authentication

Required. Pass a bearer token — see Authentication. The project must belong to the account that owns the token; requesting a project you don’t own returns 404 Not Found.

Path parameters

Parameter	Type	Description
`id`	string	The project ID whose updates you want to list.

Example request

curl https://updatify.io/api/v1/projects/PROJECT_ID/updates \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

200 OK with a JSON object containing a data array of updates.

{
  "data": [
    {
      "id": "b3f1c2d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "title": "Dark mode is here",
      "body": "<p>You can now switch between light and dark themes.</p>",
      "heroimage": "https://updatify.io/uploads/hero/dark-mode.png",
      "created_at": "2026-07-01T09:30:00Z",
      "post_type": "feature_highlight",
      "author": "Alex Bell"
    }
  ]
}

Update object

Field	Type	Description
`id`	string	Unique identifier for the update.
`title`	string	The update’s title.
`body`	string	The update body as HTML.
`heroimage`	string \| null	URL of the hero image, or `null` if none.
`created_at`	string (ISO 8601)	When the update was created.
`post_type`	string (enum)	One of `update`, `announcement`, `bugfix`, `blogpost`, `feature_highlight`.
`author`	string	Name of the user who published the update.

Errors

Status	Meaning
`401 Unauthorised`	Missing, invalid, or revoked token.
`404 Not Found`	The project doesn’t exist or isn’t owned by your account.

See Errors for details.