API keys

Revoke API key

Revoke an API key.

DEL/api-keys/{id}

Use this endpoint to revoke unused or expired API keys to maintain good security hygiene. Revoking an API key immediately revokes access, so ensure you update your applications with a new API key before revoking the old one.

Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>.

Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.

Path

idstringrequiredpath

The unique identifier of the API key to revoke.

Query

ownerstringquery

Unique identifier of the owner whose key you want to revoke.

Response

Returns 204 No Content upon successful revocation.

curl -X DELETE "http://localhost:5001/api-keys/<api-key-id>?owner=owner_id" \
  -H "X-blnk-key: <api-key>"

{}

{
  "error": "API key not found",
  "error_detail": {
    "code": "APIKEY_NOT_FOUND",
    "message": "API key not found"
  }
}