> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://autodesk-poc.ferndocs.com/v2/llms.txt
> - v1: https://autodesk-poc.ferndocs.com/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://autodesk-poc.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://autodesk-poc.ferndocs.com/_mcp/server.

# Migrating to v2

v2 is additive. It re-issues only the operations whose contract changed; every
other operation stays on `/construction/admin/v1` and is unaffected. You can
call both base paths from the same integration.

## Operations that moved to v2

| Operation                               | v1         | v2                             |
| --------------------------------------- | ---------- | ------------------------------ |
| `POST projects/:projectId/users:import` | Deprecated | Accepts a plain 2-legged token |
| `POST projects/:projectId/roles:sync`   | Available  | Re-issued in v2                |

## Import project users

The v1 import operation required a user context: a 3-legged token, or a 2-legged
token with the `User-Id` header. The v2 operation adds plain 2-legged
(`account:write`) as an accepted flow, so back-end integrations no longer need an
admin to impersonate.

**`Switching the import call to v2`**

```diff title="Switching the import call to v2"
- POST /construction/admin/v1/projects/:projectId/users:import
- Authorization: Bearer <2-legged token>
- User-Id: <admin user id>
+ POST /construction/admin/v2/projects/:projectId/users:import
+ Authorization: Bearer <2-legged token>
```

The v1 operation is marked deprecated and still works; new integrations should
target v2.

## Sync project roles

`POST projects/:projectId/roles:sync` is re-issued unchanged in shape and still
requires an impersonated or 3-legged token with `account:read`. Point new code at
the v2 path so role syncing and user importing sit on the same version.

> **Info**
>
> Everything else — projects, companies, hub users, project users, the lifecycle
> operations and the sync-status pollers — remains v1 only. Switch the version
> selector to v1 to browse them.