Accounts & Users

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), 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 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 for every endpoint, parameter and example.

Introduction

Concepts

Accounts & Users

Core concepts

Active account in the token

Access levels

Main endpoints

​Core concepts

​Active account in the token

​Access levels

​Main endpoints

Core concepts

Active account in the token

Access levels

Main endpoints