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.
Core concepts
The Tarefy API works with two main concepts:- Account — the organization that subscribes to Tarefy (a company, agency or consultancy)
- User — a person who accesses Tarefy
Active account in the token
When you sign in viaPOST /api/v2/auth/login, the JWT token returned already has a specific account as context. All subsequent calls operate within that account.
If the user belongs to multiple accounts, login returns their default account. To switch accounts, log in again specifying the desired account (see the login endpoint in the API reference).
Access levels
Each user has a level within the account that determines what they can do via the API:| Level | Typical role | Permissions |
|---|---|---|
| 1 | Owner | Full access |
| 2 | Admin | Near-full (except billing) |
| 3 | Manager | Team management and reports |
| 4 | Member | Day-to-day tasks and operations |
| 5 | External | Limited view (clients, partners) |
Main endpoints
| Endpoint | Use |
|---|---|
GET /api/v2/users | List users in the current account |
GET /api/v2/users/me | Authenticated user data |
POST /api/v2/users | Invite a new user |
PATCH /api/v2/users/{id} | Update a user |
GET /api/v2/accounts/{id} | Account details |