---
title: "Delete a Teams token"
method: DELETE
path: "/channels/teams/tokens/{token_id}"
tags: ["teams"]
---

# Delete a Teams token

`DELETE /channels/teams/tokens/{token_id}`

Deletes one of the authenticated user's Teams tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.

## Path parameters

- `token_id` string, required

## Response `200`

OK

- DiscardResult
  - `discarded_at` string — The timestamp when the token was discarded.
  - `id` string — The unique identifier for the discarded token.

---

[API](https://skmtc.net/magicbell/apis/magicbell-api.md) · [All operations](https://skmtc.net/magicbell/apis/magicbell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magicbell/magicbell-api/revisions/8b99dca11019/schema)