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

# API v2

> Version 2 of the Synci API is in alpha: only the endpoints that changed shape since v1 are published here.

<Warning>
  **Alpha.** Version 2 of the Synci API is still taking shape. Endpoints published here may change without a deprecation period until v2 is declared stable.
</Warning>

Only the endpoints that changed shape since v1 are published under `/api/v2`. Every other endpoint is still served and documented under [v1](/api-reference). Authentication, scopes, pagination and error handling are identical to v1.

```text theme={"dark"}
API root:  https://api.synci.io/api/v2
```

## What is different

Version 2 is where breaking changes land. Rather than versioning the whole surface at once, each endpoint moves to v2 only when its request or response shape has to change in a way v1 clients could not absorb. A v2 endpoint and its v1 counterpart can be used side by side with the same token.

## Using v2 safely

* Pin to the exact field names you read, and expect additions.
* Watch the [help center](https://help.synci.io) and your account email for changes to alpha endpoints; they are announced, but without the deprecation window stable endpoints get.
* Prefer v1 for anything you are not actively migrating.


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