API Reference
API Reference / Endpoints / Platform

Revoke an API key

/v1/apikeys/:keyId

Revoke an API key for the authenticated workspace.

DELETE/v1/apikeys/:keyId
Auth: API key or dashboard JWTBilling: FreeBehavior: Sync
DELETESyncNo body

When to use it

Use this when a key should stop working immediately because it is no longer needed, has leaked, or should be rotated.

Behavior on success

Returns a completed payload on the normal success path.

Integration shape

Authorization model
API key or dashboard session
Request format
No request body
Polling pattern
No polling required on the normal success path.

Request

FieldTypeRequiredDescription
keyIdstringYesKey identifier returned by create or list calls.

Example request

DELETE /v1/apikeys/:keyId
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/apikeys/key_123', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
  },
});

const payload = await response.json();
console.log(payload);

Example response

Response shapejson
{
  "success": true,
  "data": {
    "key_id": "key_123",
    "revoked": true
  }
}

Production guidance

Pair this route with idempotency on POST requests and either request polling or webhooks whenever the response is asynchronous.
Was this page helpful?
Previous
Music endpointsNext