List projects

Returns the list of projects owned by the authenticated user, newest first. Use this to discover the project id you need for listing updates.

GET /api/v1/projects

Authentication

Required. Pass a bearer token — see Authentication. Only projects owned by the account that owns the token are returned.

Example request

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

Response

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

{
  "data": [
    {
      "id": "b3f1c2d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "title": "Acme App",
      "slug": "acme-app",
      "widget_title": "What's new",
      "updates_count": 12,
      "created_at": "2026-01-15T08:00:00Z"
    }
  ]
}

Project object

Field	Type	Description
id	string	Unique identifier for the project. Use this as the {id} in other endpoints.
title	string	The project’s title.
slug	string	URL-friendly slug for the project.
widget_title	string | null	Title shown in the release notes widget, or null if not set.
updates_count	integer	Total number of updates in the project.
created_at	string (ISO 8601)	When the project was created.

Errors

Status	Meaning
401 Unauthorised	Missing, invalid, or revoked token.

See Errors for details.