> ## 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.

# Welcome to the Tarefy API

> Team task management, culture and performance — now programmable

The **Tarefy API** lets you integrate Tarefy with your systems — automating task creation, syncing users, exporting reports, and much more.

## Overview

The API is REST, returns JSON, and authenticates via JWT Bearer Token. All endpoints live under the `/v2` prefix and follow standard HTTP conventions (verbs, status codes, headers).

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first call in under 5 minutes
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    How to get and use your JWT token
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Hundreds of endpoints documented with examples
  </Card>

  <Card title="Service status" icon="signal-bars" href="https://status.tarefy.com">
    Real-time availability
  </Card>
</CardGroup>

## Base URL

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

All examples in the docs use this URL.

## API standards

* **Format:** JSON in request and response
* **Versioning:** `/v2` prefix (v1 is legacy, not documented)
* **Authentication:** `Authorization: Bearer <token>` on every call
* **Status codes:** standard HTTP (2xx success, 4xx client error, 5xx server error)
* **Timezone:** the API normalizes everything to UTC (ISO 8601)
* **Encoding:** UTF-8

## Limits and rate limiting

There is no aggressive rate limiting yet. We recommend nonetheless:

* No more than **10 requests/second** per token
* Use pagination (`page` + `pageSize`) on large lists
* Cache idempotent responses on your client

## Support

Questions, suggestions or issues? Email [suporte@tarefy.com](mailto:suporte@tarefy.com).
