# Tabnine APIs ## Tabnine API reference Use these APIs to query usage, retrieve audit data, and automate administration. This page renders the latest unified OpenAPI spec. ### Authentication All APIs return JSON. Authenticate with a Personal Access Token in the `Authorization: Bearer ` header. Any user can create a Personal Access Token. 1. Go to **Settings** → **Access Tokens**. 2. Click **Generate Token**. 3. Enter a name and expiration. 4. 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. See [Personal Access Tokens](/main/administering-tabnine/managing-your-team/settings/access-tokens.md) for token management. {% hint style="info" %} Use the API for automation and [Analytics (Usage Reports)](/main/administering-tabnine/managing-your-team/reporting.md) for dashboard views. {% endhint %} ### Usage metrics The Usage API 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 organization 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 and 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 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 role management The User Management API 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 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**
FieldTypeRequiredDescription
repo_typestringYesRepository type: "git" or "perforce"
repository_linkstringYesGit: repository URL in SSH or HTTPS format. Perforce: depot path such as //depot/main
latest_statusstringRead-onlyCurrent indexing status
last_indexed_successfullystring or nullRead-onlyISO 8601 timestamp of last successful indexing, or null if never indexed
**Git-specific fields**
FieldTypeRequiredDescription
authentication_methodstringYes"ssh" or "https"
authentication_credentials_namestringConditionalRequired when authentication_method is "https"
view_source_link_patternstringNoURL pattern for viewing source code. Supports {sha}, {path}, and {line}
**Perforce-specific fields**
FieldTypeRequiredDescription
authentication_credentials_namestringYesMust match an existing Perforce credential name for the team
view_source_link_patternstringNoCurrently 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 Use these endpoints to retrieve aggregated agent usage analytics by organization, team, or user. #### Get organization agent usage {% openapi src="" path="/api/v1/organization/agent-usage" method="get" %} {% endopenapi %} #### Get team agent usage {% openapi src="" path="/api/v1/team/agent-usage" method="get" %} {% endopenapi %} #### Get user agent usage {% openapi src="" path="/api/v1/user/agent-usage" method="get" %} {% endopenapi %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.tabnine.com/main/administering-tabnine/managing-your-team/tabnine-apis.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.