---
title: "Remove a Team Member"
method: DELETE
path: "/v1/teams/{teamId}/members/{uid}"
tags: ["teams"]
---

# Remove a Team Member

`DELETE /v1/teams/{teamId}/members/{uid}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/teams/{teamId}/members/{uid}`
- Auth: HTTP bearer

Remove a Team Member from the Team, or dismiss a user that requested access, or leave a team. Directory Sync members can be removed when their directory email is absent or does not match the user's primary or verified secondary emails.

## Path parameters

- `uid` string, required: The user ID of the member.
- `teamId` string, required: The unique team identifier

## Query parameters

- `newDefaultTeamId` string: The ID of the team to set as the new default team for the Northstar user.

## Response `200`

Successfully removed a member of the team.

- object
  - `id` string, required: ID of the team.

## 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. Not authorized to update the team.
- `404`
- `410`
- `503`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-01-22** `c12186034433`: 1 breaking
  - added the new path request parameter `teamId`
- **2025-03-19** `37b482c58c92`: 3 info
  - added the new optional `query` request parameter `newDefaultTeamId`
  - added the non-success response with the status `401`
  - added the non-success response with the status `503`

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/teams/:teamId/members/:uid/delete.md)

---

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