# Tabnine APIs ## Enable APIs by Token Use these APIs to query usage, retrieve audit data, and automate team administration in Tabnine Enterprise. ### Authentication All APIs return JSON and require an access token. Only users with Admin access can generate tokens. 1. Go to **Settings** > **Access Tokens**. 2. Click **Generate token**. 3. Enter a token description. 4. Click **Generate Token**. 5. Copy the token before closing the dialog.

Generate a new token in the Access Tokens section

If you lose a token, revoke it and generate a new one. ### USAGE METRICS The Usage API, released with **5.18.0**, provides programmatic access to usage metrics across an organization. It is available to Enterprise SaaS and private installations. #### ORGANIZATIONS Use these endpoints to retrieve organization-wide metadata and usage. #### **GET CURRENT ORGANIZATION** {% openapi src="" path="/api/v1/organization" method="get" %} {% endopenapi %} #### **GET LIST OF TEAMS** {% openapi src="" path="/api/v1/organization/teams" method="get" %} {% endopenapi %} #### **GET ACCOUNT USAGE INFO** {% openapi src="" path="/api/v1/organization/account-utilizations" method="get" %} {% endopenapi %} #### **GET ORG-LEVEL USAGE** {% openapi src="" path="/api/v1/organization/usage" method="get" %} {% endopenapi %} #### **GET USERS NOT ASSIGNED TO TEAMS** {% openapi src="" path="/api/v1/organization/users" method="get" %} {% endopenapi %} ### LICENSES & PERMISSIONS Use these endpoints to validate entitlements and enabled permissions. #### **GET LICENSE INFO** Returns license metadata for the current Tabnine instance. {% openapi src="" path="/api/v1/license" method="get" %} {% endopenapi %} #### **GET ACCOUNT PERMISSIONS INFO** Returns the permissions enabled on this Tabnine instance. {% openapi src="" path="/api/v1/instance/permissions" method="get" %} {% endopenapi %} ## TEAMS AND USERS Use these endpoints to retrieve team-level and user-level usage data. #### GET TEAM USERS {% openapi src="" path="/api/v1/team/{teamId}/users" method="get" %} {% endopenapi %} #### **GET TEAM USAGE INFO** {% openapi src="" path="/api/v1/team/account-utilizations" method="get" %} {% endopenapi %} **GET TEAM INFO BY `teamId`** {% openapi src="" path="/api/v1/team/{teamId}" method="get" %} {% endopenapi %} **GET TEAM-WIDE USAGE** {% openapi src="" path="/api/v1/team/usage" method="get" %} {% endopenapi %} **Get user info by `user_id`**

{% openapi src="" path="/api/v1/user/{user\_id}" method="get" %} {% endopenapi %} **Get user usage** {% openapi src="" path="/api/v1/user/usage" method="get" %} {% endopenapi %} ### AUDIT LOGS The Audit Logs API, released with **5.25.0**, returns audit events for user management, team management, and authentication activity. The audit log includes: * Performing user * Affected user * Time of change * Value change for each event You can use the same mapping from the Usage Metrics API between `user_id` and email, and between `team_id` and team name. {% openapi src="" path="/api/v1/organization/audit-logs" method="get" %} {% endopenapi %} ### USER MANAGEMENT The User Management API, released with **5.27.0**, automates user role management and team membership. #### UPDATE USER

{% openapi src="" path="/api/user/v1/{userId}" method="patch" %} {% endopenapi %} #### Permissions | Role | Assign Team | Update Role | Activate/Deactivate | Invite | | --------- | ----------- | ------------------------------ | ------------------- | ------------------------------ | | Admin | ✓ | ✓ (all roles) | ✓ | ✓ (all roles) | | Manager | ✓ | ✓ (Member, Team Lead, Manager) | ✓ | ✓ (Member, Team Lead, Manager) | | Team Lead | ✗ | ✗ | ✗ | ✗ | | Member | ✗ | ✗ | ✗ | ✗ | To use this API, you will need user and team data from the organization and team APIs above. ### TEAM REPOSITORIES The Repository Management API, released with **5.27.0**, automates repository connection management for teams. All endpoints follow this structure: `/api/team/v1/{teamId}/connections/repositories` As of 5.27.0, only Admins have permission for this endpoint. #### LIST REPOSITORIES {% openapi src="" path="/api/team/v1/{teamId}/connections/repositories" method="get" %} {% endopenapi %} #### ADD REPOSITORY {% openapi src="" path="/api/team/v1/{teamId}/connections/repositories" method="post" %} {% endopenapi %} #### UPDATE REPOSITORY {% openapi src="" path="/api/team/v1/{teamId}/connections/repositories/{repositoryLink}" method="put" %} {% endopenapi %} #### DELETE REPOSITORY {% openapi src="" path="/api/team/v1/{teamId}/connections/repositories/{repositoryLink}" method="delete" %} {% endopenapi %} #### Field descriptions **Common fields**

Field	Type	Required	Description
`repo_type`	string	Yes	Repository type: "git" or "perforce"
`repository_link`	string	Yes	Git: repository URL in SSH or HTTPS format. Perforce: depot path such as //depot/main
`latest_status`	string	Read-only	Current indexing status
`last_indexed_successfully`	string or null	Read-only	ISO 8601 timestamp of last successful indexing, or null if never indexed

**Git-specific fields**

Field	Type	Required	Description
`authentication_method`	string	Yes	"ssh" or "https"
`authentication_credentials_name`	string	Conditional	Required when `authentication_method` is "https"
`view_source_link_pattern`	string	No	URL pattern for viewing source code. Supports `{sha}`, `{path}`, and `{line}`

**Perforce-specific fields**

Field	Type	Required	Description
`authentication_credentials_name`	string	Yes	Must match an existing Perforce credential name for the team
`view_source_link_pattern`	string	No	Currently not used for Perforce

**Status values** | Status | Description | | ---------- | ----------------------------------------- | | `pending` | Repository is queued for initial indexing | | `cloning` | Repository is being cloned | | `indexing` | Repository is currently being indexed | | `success` | Repository was successfully indexed | | `failed` | Last indexing attempt failed | {% hint style="info" %} Perforce depots typically skip `cloning` and go directly to indexing. {% endhint %} ### TEAM MANAGEMENT Use these APIs to manage teams, users, and invitations in Tabnine Enterprise. #### CREATE A TEAM Introduced in 6.0.0. {% openapi src="" path="/api/team/v1" method="post" %} {% endopenapi %} #### **GET TEAM BY ID** {% openapi src="" path="/api/team/v1/{id}" method="get" %} {% endopenapi %} #### **RENAME TEAM** {% openapi src="" path="/api/team/v1/{id}" method="put" %} {% endopenapi %} ### USER MANAGEMENT #### **GET USER INFO** {% openapi src="" path="/api/user/v1/{userId}" method="get" %} {% endopenapi %} #### UPDATE USER PROPERTIES {% openapi src="" path="/api/user/v1/{userId}" method="patch" %} {% endopenapi %} #### **LOOK UP USER BY EMAIL** {% openapi src="" path="/api/user/v1/by-email/{email}" method="get" %} {% endopenapi %} #### **LIST USER'S ALLOWED TEAMS** {% openapi src="" path="/api/user/v1/{userId}/allowed-teams" method="get" %} {% endopenapi %} **Add teams to a user's allowed list** {% openapi src="" path="/api/user/v1/{userId}/allowed-teams" method="patch" %} {% endopenapi %} **Remove teams from a user's allowed list** {% openapi src="" path="/api/user/v1/{userId}/allowed-teams" method="delete" %} {% endopenapi %} ### INVITATION MANAGEMENT #### **INVITE USER BY EMAIL** Use this endpoint to invite a user to a team by email. {% openapi src="" path="/api/invitation/v1" method="post" %} {% endopenapi %} #### **LIST PENDING INVITES** {% openapi src="" path="/api/invitation/v1" method="get" %} {% endopenapi %} #### **REVOKE INVITES BY ID** {% openapi src="" path="/api/invitation/v1" method="delete" %} {% endopenapi %} ### AGENT USAGE This API returns aggregated usage analytics for your organization, broken down by AI tools such as agent, chat, code completions, and instruct over a time range. #### TOOLS USAGE {% openapi src="" path="/api/v1/organization/usage" method="get" %} {% endopenapi %}