# Revoke api-token

## POST /api/revoke

> Revokes an API token, effectively invalidating its access privileges.\
> \
> Once revoked, the token can no longer be used to access protected resources or perform actions on the API.\
>

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"Revoke API Token","version":"1.0.0"},"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/api/revoke":{"post":{"description":"Revokes an API token, effectively invalidating its access privileges.\n\nOnce revoked, the token can no longer be used to access protected resources or perform actions on the API.\n","tags":["Revoke API Token"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["brand_id","password"],"properties":{"brand_id":{"type":"string","description":"Unique identifier for the brand, provided by the TBB platform."},"password":{"type":"string","description":"Password associated with the brand, provided by the TBB platform."}}}}}},"responses":{"200":{"description":"Token successfully revoked.","content":{"application/json":{"schema":{"type":"array","items":{}}}}},"401":{"description":"Unauthorized - Invalid credentials or token","content":{"application/json":{"schema":{"type":"object","required":["status","errors"],"properties":{"status":{"type":"string"},"errors":{"type":"array","items":{"type":"string"}}}}}}}}}}}}
```

