List clients

Discover active workspace clients according to the API key owner’s role.

GET /api/v1/clients

Required scope: clients:read

Owners and admins receive all active clients in the bound workspace, including empty clients. Other members receive clients with at least one active assigned project. Archived clients are excluded. Results sort by client name.

Request

Requires bearer authentication and clients:read. No query parameters or body are needed. This list is not paginated.

curl "https://www.tracktimer.app/api/v1/clients" \
  --header "Authorization: Bearer $TRACKTIMER_API_KEY"

Response — 200

clients: array, possibly empty.
clients[].id: client UUID.
clients[].name: nonempty client name.

{
  "canCreateProjects": false,
  "clients": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Northstar"
    }
  ]
}

canCreateProjects is true only when the current user is an owner or admin and the key includes projects:write. When true, create a project for an empty client; its creator is assigned automatically. Use a returned ID with list projects. Authentication, scope, rate-limit, and server failures use shared errors.