DELETE /api/v1/auth/service-token/{guid}
Revoke Service Token
Revoke a read-only service user: deactivate + kill all minted tokens.
Effective immediately — auth re-reads the user row on every request. Only read-only agent identities are addressable here (404 otherwise), so a typo’d guid can never lock out a human/admin account.
Auth: Authorization: Bearer <token> required
Request
Section titled “Request”curl -sS -X DELETE "https://entherium.duckdns.org:8443/api/v1/auth/service-token/<guid>" \ -H "Authorization: Bearer <token>"Response 204
Section titled “Response 204”The contract carries no example for this response; schema: —. Field-level shape: interactive explorer.
Returns
Section titled “Returns”No body.
Parameters
Section titled “Parameters”| Parameter | In | Required | Type | Default | Constraints | Description |
|---|---|---|---|---|---|---|
guid | path | yes | integer | — | — | |
Idempotency-Key | header | no | string | — | uuid | Optional. |
Errors
Section titled “Errors”| Code | Meaning | Body |
|---|---|---|
401 | Missing or invalid authentication credentials | ErrorResponse |
422 | Validation Error | HTTPValidationError |
Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.