> This page is for Developer Documentation.

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

## Promoted Organization and Team Membership APIs to v2

The Organization and Team Membership APIs have been promoted from `v2-alpha` to `v2`! The `v2-alpha` endpoints are currently marked deprecated, and will be fully sunset on **September 10th 2024**

### What’s changing?

The [Organization](https://benchling.com/api/v2-alpha/reference#/Organizations) and [Team](https://benchling.com/api/v2-alpha/reference#/Teams) Membership APIs have been promoted from `v2-alpha` to `v2` stability and are now generally available. These APIs allow integrations to programmatically add and/or remove members from teams and organizations, or to change user roles within a team or organization. The existing `v2-alpha` endpoints are still functional, but are now marked as deprecated; the corresponding `v2` endpoint(s) should be used instead:

| `v2-alpha` endpoint                                                                                                                                                    | `v2` endpoint                                                                                                                                           |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [GET /v2-alpha/organizations/\{organization\_id}/memberships](https://benchling.com/api/v2-alpha/reference#/Organizations/listOrganizationMemberships)                 | [GET /v2/organizations/\{organization\_id}/memberships](https://benchling.com/api/reference#/Organizations/listOrganizationMemberships)                 |
| [POST /v2-alpha/organizations/\{organization\_id}/memberships](https://benchling.com/api/v2-alpha/reference#/Organizations/createOrganizationMembership)               | [POST /v2/organizations/\{organization\_id}/memberships](https://benchling.com/api/reference#/Organizations/createOrganizationMembership)               |
| [DELETE /v2-alpha/organizations/\{organization\_id}/memberships/\{user\_id}](https://benchling.com/api/v2-alpha/reference#/Organizations/deleteOrganizationMembership) | [DELETE /v2/organizations/\{organization\_id}/memberships/\{user\_id}](https://benchling.com/api/reference#/Organizations/deleteOrganizationMembership) |
| [GET /v2-alpha/organizations/\{organization\_id}/memberships/\{user\_id}](https://benchling.com/api/v2-alpha/reference#/Organizations/getOrganizationMembership)       | [GET /v2/organizations/\{organization\_id}/memberships/\{user\_id}](https://benchling.com/api/reference#/Organizations/getOrganizationMembership)       |
| [PATCH /v2-alpha/organizations/\{organization\_id}/memberships/\{user\_id}](https://benchling.com/api/v2-alpha/reference#/Organizations/updateOrganizationMembership)  | [PATCH /v2/organizations/\{organization\_id}/memberships/\{user\_id}](https://benchling.com/api/reference#/Organizations/updateOrganizationMembership)  |
| [POST /v2-alpha/teams](https://benchling.com/api/v2-alpha/reference#/Teams/createTeam)                                                                                 | [POST /v2/teams](https://benchling.com/api/reference#/Teams/createTeam)                                                                                 |
| [PATCH /v2-alpha/teams/\{team\_id}](https://benchling.com/api/v2-alpha/reference#/Teams/updateTeam)                                                                    | [PATCH /v2/teams/\{team\_id}](https://benchling.com/api/reference#/Teams/updateTeam)                                                                    |
| [GET /v2-alpha/teams/\{team\_id}/memberships](https://benchling.com/api/v2-alpha/reference#/Teams/listTeamMemberships)                                                 | [GET /v2/teams/\{team\_id}/memberships](https://benchling.com/api/reference#/Teams/listTeamMemberships)                                                 |
| [POST /v2-alpha/teams/\{team\_id}/memberships](https://benchling.com/api/v2-alpha/reference#/Teams/createTeamMembership)                                               | [POST /v2/teams/\{team\_id}/memberships](https://benchling.com/api/reference#/Teams/createTeamMembership)                                               |
| [DELETE /v2-alpha/teams/\{team\_id}/memberships/\{user\_id}](https://benchling.com/api/v2-alpha/reference#/Teams/deleteTeamMembership)                                 | [DELETE /v2/teams/\{team\_id}/memberships/\{user\_id}](https://benchling.com/api/reference#/Teams/deleteTeamMembership)                                 |
| [GET /v2-alpha/teams/\{team\_id}/memberships/\{user\_id}](https://benchling.com/api/v2-alpha/reference#/Teams/getTeamMembership)                                       | [GET /v2/teams/\{team\_id}/memberships/\{user\_id}](https://benchling.com/api/reference#/Teams/getTeamMembership)                                       |
| [PATCH /v2-alpha/teams/\{team\_id}/memberships/\{user\_id}](https://benchling.com/api/v2-alpha/reference#/Teams/updateTeamMembership)                                  | [PATCH /v2/teams/\{team\_id}/memberships/\{user\_id}](https://benchling.com/api/reference#/Teams/updateTeamMembership)                                  |

These legacy `v2-alpha` endpoints will be fully sunset on **September 10th 2024**.

### When is this happening?

The `v2` Organization and Team endpoints are now live! The legacy `v2-alpha` endpoints are currently marked deprecated, and will be fully sunset on **September 10th 2024**