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

# Accounts & Users

> How the API models the relationship between users and accounts

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

A single user can belong to **multiple accounts** — for example, a consultant serving several companies, or a professional working in more than one agency.

## Active account in the token

When you sign in via `POST /v2/auth/login` (see the [authentication guide](/authentication)), 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) |

Endpoints requiring specific permissions return **403 Forbidden** when the user does not have the right level. See [Permissions](/essentials/permissions) for details.

## Main endpoints

| Endpoint                | Use                               |
| ----------------------- | --------------------------------- |
| `GET /v2/users`         | List users in the current account |
| `GET /v2/users/me`      | Authenticated user data           |
| `POST /v2/users`        | Invite a new user                 |
| `PATCH /v2/users/{id}`  | Update a user                     |
| `GET /v2/accounts/{id}` | Account details                   |

See the [full API reference](/api-reference) for every endpoint, parameter and example.