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

# Migrate to a new connector version

> Periodically we release a new version of a connector in order to add additional capabilities. Here's what to know about those v2 connectors, our support for v1 connectors, and how to migrate.

## Why are some connectors marked v2?

We’ve learned a lot since we started building connectors! One key advancement was the creation of the Baton framework for connector development, which C1 launched in December 2022.

Since then, we’ve rolled out updated versions of some connectors that were written pre-Baton in order to modernize the connectors’ architecture, improve their performance, and enable new capabilities. (See the table below for an overview of new capabilities in v2 connectors.)

## What happens to the v1 connector when a v2 is launched?

We want anyone setting up a connector for the first time to use the latest and greatest version, so when a v2 version is launched, we mark the original (v1) connector with a **v2 available** label on your **Connectors** page. This is intended primarily to lessen the chances that someone will set up a v1 connector by accident when a shiny new v2 version is available.

## Are v1 connectors still safe to use?

Absolutely. We continue to support both versions of a connector so long as they’re in use.

If we decide in the future to retire a v1 connector entirely, we’ll be in touch with anyone still using that connector well in advance of its retirement, and will provide support and guidance for migrating to the new version.

## Migrate from a v1 to a v2 connector

<Warning>
  **Important: Migrating from a v1 to a v2 connector replaces internal identifiers.** When you set up a v2 connector — whether in a new app or the same app as the v1 connector — ConductorOne generates new app user IDs and entitlement IDs. Any existing tasks, access reviews, access review templates, or access profiles that reference the old v1 app’s users or entitlements will no longer resolve to the correct resources. Plan accordingly and review your tasks and access profiles after completing the migration.
</Warning>

The basic process for migration is as follows (see the special note below about migrating IdP connectors):

<Steps>
  <Step>
    Leave the v1 connector running as-is.
  </Step>

  <Step>
    Set up the v2 connector in a new C1 app.
    When you set up the v2 connector, select the **Create a new managed app** option.
  </Step>

  <Step>
    Configure and test the v2 connector as needed.
  </Step>

  <Step>
    When you’re confident the v2 connector is working as expected, remove the v1 connector and its associated app. Then update any access reviews, access review templates and access profiles that referenced the old app’s users or entitlements to point to the corresponding resources in the new v2 app.
  </Step>
</Steps>

<Warning>
  **This is a rip-and-replace process, not an in-place migration.** Because you are creating a new app for the v2 connector, app user IDs and entitlement IDs will change. Any existing tasks or access profiles that reference IDs from the v1 app will break and need to be reconfigured for the new v2 app.
</Warning>

Depending on the complexity of the connected software and how you’ve set it up in C1, this process might be quite simple, or a bit more complex. Our Customer Success team is always ready to talk through the process with you and provide advice and support.

<Tip>
  **Thinking of migrating an IdP connector?**

  If you’re ready to migrate to a v2 version of your identity provider (IdP) connector, make sure to [talk with our support team before you proceed](/baton/migration/). Due to how IdP apps pull in child apps these connector migrations can have some special complexities, and we can help make sure the migration goes smoothly.
</Tip>

## Version comparison

The table below outlines the differences between the v1 and v2 connectors, highlighting the key improvements in each newer version.

| v1 connector docs                                        | v2 connector docs                                                           | Key capability changes and improvements in v2                                                                    |
| :------------------------------------------------------- | :-------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
| [AWS v1](/baton/v1/aws)                                  | [AWS v2](/baton/aws)                                                        | Syncs IAM roles and IAM groups   Provisions IAM groups                                                           |
| [Azure Active Directory](/baton/v1/azure)                | [Microsoft Entra ID](/baton/microsoft-entra)                                | Syncs enterprise applications and licenses                                                                       |
| [BambooHR v1](/baton/v1/bamboohr)                        | [BambooHR v2](/baton/bamboohr)                                              | Modernized backend architecture (no capability changes)                                                          |
| [Cloudflare v1](/baton/v1/cloudflare)                    | [Cloudflare v2](/baton/cloudflare)                                          | Modernized backend architecture (no capability changes)                                                          |
| [Confluence v1](/baton/v1/confluence)                    | [Confluence v2](/baton/confluence)                                          | Syncs spaces and space permissions   Provisions groups and space permissions                                     |
| [Coupa v1](/baton/v1/coupa)                              | [Coupa v2](/baton/coupa)                                                    | Provisions groups, roles, and licenses                                                                           |
| [Datadog v1](/baton/v1/datadog)                          | [Datadog v2](/baton/datadog)                                                | Syncs teams   Provisions roles and teams                                                                         |
| [Docusign v1](/baton/v1/docusign)                        | [Docusign v2](/baton/docusign)                                              | Provisions accounts                                                                                              |
| [GitHub v1](/baton/v1/github)                            | [GitHub v2](/baton/github)                                                  | Provisions repositories and orgs                                                                                 |
| [GitLab v1](/baton/v1/gitlab)                            | [GitLab v2](/baton/gitlab)                                                  | Provisions accounts, projects, and groups                                                                        |
| [Google Cloud Platform](/baton/v1/google-cloud-platform) | [Google Cloud Platform with Google Workspace](/baton/google-cloud-platform) | Syncs groups, Workforce Identity pools and pool providers, secrets   Provisions groups, Workforce Identity pools |
| [Google Workspace v1](/baton/v1/google-workspace)        | [Google Workspace v2](/baton/google-workspace)                              | Modernized backend architecture (no capability changes)                                                          |
| [Okta v1](/baton/v1/okta)                                | [Okta v2](/baton/okta)                                                      | Syncs custom org roles                                                                                           |
| [OneLogin v1](/baton/v1/onelogin)                        | [OneLogin v2](/baton/onelogin)                                              | Syncs groups                                                                                                     |
| [Ramp v1](/baton/v1/ramp)                                | [Ramp v2](/baton/ramp)                                                      | Modernized backend architecture (no capability changes)                                                          |
| [Salesforce v1](/baton/v1/salesforce)                    | [Salesforce v2](/baton/salesforce)                                          | Syncs profiles and applications   Provisions groups, roles, permission sets, and profiles                        |
| [Sentry v1](/baton/v1/sentry)                            | [Sentry v2](/baton/sentry)                                                  | Provisions accounts, projects, and teams                                                                         |
| [Snowflake v1](/baton/v1/snowflake)                      | [Snowflake v2](/baton/snowflake)                                            | Syncs databases   Provisions roles                                                                               |
| [Tailscale v1](/baton/v1/tailscale)                      | [Tailscale v2](/baton/tailscale)                                            | Provisions roles                                                                                                 |
| [Twingate v1](/baton/v1/twingate)                        | [Twingate v2](/baton/twingate)                                              | Modernized backend architecture (no capability changes)                                                          |
| [Zendesk v1](/baton/v1/zendesk)                          | [Zendesk v2](/baton/zendesk)                                                | Syncs roles   Provisions accounts, organizations, groups, and roles                                              |