> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tarefy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conventions

> Standards used across every Tarefy API endpoint

## Version prefix

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

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

## Authentication

All calls require the header:

```http theme={null}
Authorization: Bearer YOUR_JWT
```

See [Authentication](/authentication) for details.

## Dates and times

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.

## Pagination

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

```bash theme={null}
GET /v2/tasks?page=1&pageSize=50
```

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

The response includes metadata:

```json theme={null}
{
  "data": [...],
  "total": 1450,
  "page": 1,
  "pageSize": 50
}
```

## Error format

See [Errors](/essentials/errors) for the full structure.