Skip to main content
DELETE
http://localhost:5001
/
api-keys
/
{id}
curl --request DELETE \
  --url 'http://localhost:5001/api-keys/<api-key-id>?owner=owner_id' \
  --header 'X-blnk-key: <api-key>'

{}

​
Overview

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.
Available on version 0.10.1 or later. Requires master key authentication (the server.secret_key from your configuration).

​
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. See also: Secure your Blnk server

​
Path Parameters

​
id
string
required
The unique identifier of the API key to revoke.

​
Query Parameters

​
owner
string
required
Unique identifier of the owner. Required to revoke API keys for a specific owner.

​
Response

Returns 204 No Content upon successful revocation. 
curl --request DELETE \
  --url 'http://localhost:5001/api-keys/<api-key-id>?owner=owner_id' \
  --header 'X-blnk-key: <api-key>'

{}

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.
Tip: Connect to Blnk Cloud to see your Core data.You can view your transactions, manage identities, create custom reports, invite other team members to collaborate, and perform operations on your Core — all in one dashboard.Check out Blnk Cloud →