> ## Documentation Index
> Fetch the complete documentation index at: https://developers.teambuilder.ge/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> New endpoints, additive changes and deprecations in the TeamBuilder API.

Additive changes within `/v1` are listed here as they ship. Breaking changes only ever arrive in a new version; the version it replaces keeps working for at least six months after its deprecation is announced here. See [Versioning](/reference/versioning).

<Update label="20 October 2026" description="v1 launch" tags={["New"]}>
  ## TeamBuilder API v1

  The first public version of the TeamBuilder API.

  **Endpoints**

  | Method | Path | Scope |
  | - | - | - |
  | `GET` | [`/v1/ping`](/api-reference/status/check-your-api-key) | any key |
  | `GET` | [`/v1/employees`](/api-reference/employees/list-employees) | `employees:read` |
  | `GET` | [`/v1/employees/{id}`](/api-reference/employees/retrieve-an-employee) | `employees:read` |
  | `GET` | [`/v1/employees/{id}/stats`](/api-reference/employees/retrieve-employee-stats) | `employees:read` |
  | `GET` | [`/v1/employees/{id}/badges`](/api-reference/employees/list-employee-badges) | `employees:read` |
  | `PUT` | [`/v1/employees/sync`](/api-reference/roster-sync/sync-your-employee-roster) | `employees:write` |
  | `GET` | [`/v1/leaderboard`](/api-reference/leaderboard/get-the-leaderboard) | `leaderboard:read` |
  | `GET` | [`/v1/leaderboard/by-department`](/api-reference/leaderboard/get-the-leaderboard-by-department) | `leaderboard:read` |
  | `GET` | [`/v1/departments`](/api-reference/departments/list-departments) | `departments:read` |
  | `GET` | [`/v1/shop/items`](/api-reference/shop/list-shop-items) | `shop:read` |

  **Platform**

  * `tb_live_` and `tb_test_` API keys with per-endpoint scopes; test keys read a seeded [sandbox company](/guides/sandbox).
  * 60 requests per minute per key, reported in `X-RateLimit-*` headers.
  * One error shape with stable codes and a `request_id` on every response.
  * Opaque cursor pagination on every list.
  * Leaderboards ranked by XP for `all_time`, `this_month`, `last_3_months` and `last_year`.
</Update>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.