API Keysv4

Deprecate an API key

DELETE/api-keys/{apiKey}

Deprecates (revokes) an API key. The key stops authenticating immediately and its number/channel ownership is released. Deprecation is idempotent and cannot be undone via the API.

Blooio Apps (OAuth) only. Requires the apikeys:manage scope. API-key and dashboard authentication are rejected with 403 oauth_token_required.

Path parameters

apiKeyRequiredstring

The API key value (prefixed with api_), as returned when the key was created or by the List API keys endpoint.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalobject

api_keyoptionalstring

deprecatedoptionalboolean

Response codes

200The key was deprecated.

401Your API key is missing or invalid. Pass it as a bearer token.

403Your API key isn't allowed to access this api key (blocked key or plan limit).

404No api key was found with the provided `apiKey`.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X DELETE https://api.blooio.com/v4/api-keys/sk_live_a1b2c3d4 \

  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "data": {    "api_key": "sk_live_a1b2c3d4",    "deprecated": false  }}