Conventions - Tarefy

Version prefix

Every public API endpoint starts with /v2. The v1 version is legacy and not documented.

https://app.tarefy.com/nodeapi/v2/...

All calls require the header:

Authorization: Bearer YOUR_JWT

See Authentication for details.

Dates in responses and payloads are ISO 8601 in UTC:

2026-05-12T18:00:00Z

The product’s internal timezone is America/Sao_Paulo (UTC-3), but the API normalizes everything to UTC to avoid ambiguity.

Large lists (tasks, clients, users, etc.) support pagination via query params:

GET /v2/tasks?page=1&pageSize=50

Param	Default	Max
`page`	`1`	—
`pageSize`	`20`	`100`

The response includes metadata:

{
  "data": [...],
  "total": 1450,
  "page": 1,
  "pageSize": 50
}

See Errors for the full structure.