---
title: "Revoke a key"
method: DELETE
path: "/v1/keys/{id}"
tags: ["Account"]
---

# Revoke a key

`DELETE /v1/keys/{id}`

## Request

- Base URL: `https://api.locio.com.au`
- URL: `https://api.locio.com.au/v1/keys/{id}`
- Auth: API key in cookie `locio_session`

Immediate. A key belonging to another account answers 404, the same as one that never existed.

## Path parameters

- `id` integer, required

## Response `204`

Revoked.

## Other responses

- `401`: No key, or not a valid one. Revoked and unknown keys answer the same way.
- `402`: The quota for this billing period is spent. `X-Quota-Reset` says when it returns; the billing portal is how to raise it sooner.
- `404`: No such key.
- `429`: Too many requests a second for this plan. `RateLimit-Limit` says the rate and `Retry-After` says how long to wait; this is a rate, not a quota, so it clears in a second.

---

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