---
title: "Remove Organization Team"
method: POST
path: "/auth/organization/remove-team"
tags: ["Organization Management"]
---

# Remove Organization Team

`POST /auth/organization/remove-team`

Remove a team from an organization

## Request body

- object
  - `teamId` string, required — The team ID of the team to remove. Eg: "team-id"
  - `organizationId` string — The organization ID which the team falls under. If not provided, it will default to the user's active organization. Eg: "organization-id"

## Response `200`

Success

- object
  - `message` 'Team removed successfully.', required — Confirmation message indicating successful removal

## Other responses

- `401` — Missing or invalid credentials

## Changes

- **2026-08-24** `200744ae0bef` — 1 breaking
  - the request property `organizationId` became not nullable
- **2026-08-24** `08bbb5bedb5d` — 2 breaking, 6 info
  - the request property `organizationId` became not nullable
  - removed the media type `application/json` for the response with the status `401`
  - the endpoint scheme security `bearerAuth` was removed from the API
  - removed the non-success response with the status `400`
  - …4 more
- **2026-03-05** `c45ef22a736c` — 1 info
  - the request property `organizationId` became nullable
- **2026-03-04** `21aca40b5846` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/auth/organization/remove-team/post.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)