---
title: "Revoke one of your own tokens"
method: DELETE
path: "/tokens/{tokenId}"
tags: ["admin"]
---

# Revoke one of your own tokens

`DELETE /tokens/{tokenId}`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/tokens/{tokenId}`
- Auth: HTTP bearer

Revokes a token the calling user owns, and only one they own. A token belonging to another member or another organization is reported as not found, so this route cannot be used to discover token ids. Revocation takes effect immediately.

## Path parameters

- `tokenId` string, required

## Response `200`

Token revoked (or was already revoked).

- RevokeTokenResult
  - `kind` 'revoked' | 'already-revoked', required
  - `tokenId` string, required
  - `revokedAt` integer, required

## Other responses

- `404`: No such token owned by the caller.

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)