---
title: "Delete Team from Organization"
method: DELETE
path: "/v1/organizations/{organizationId}/teams/{targetTeamId}"
tags: ["organizations"]
---

# Delete Team from Organization

`DELETE /v1/organizations/{organizationId}/teams/{targetTeamId}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/organizations/{organizationId}/teams/{targetTeamId}`
- Auth: HTTP bearer

Delete a team from an organization. This endpoint is in private beta. Contact your Vercel account team for access.

## Path parameters

- `organizationId` string, required: The ID of the organization.
- `targetTeamId` string, required: The ID of the team to remove.

## Response `200`

- object
  - `organizationId` string, required
  - `teamId` string, required

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `409`
- `410`

## Changes

- **2026-10-16** `0e48cb239c6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/v1/organizations/:organizationId/teams/:targetTeamId/delete.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) - [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/api/revisions/4a06e85c2848?raw)