Docs/SDK Reference

SDK Reference

Full API reference for the KeyVault Edge Node.js and Python SDKs, plus the REST API and webhook event types.

Node.js SDK

Install
npm install @keyvault-edge/sdk
Initialise
import { KeyVaultEdge } from '@keyvault-edge/sdk'; const kve = new KeyVaultEdge({  apiKey: process.env.KVE_API_KEY,});
Create a token
const token = await kve.tokens.create({  name: 'openai-prod',  realKey: process.env.OPENAI_API_KEY,  provider: 'openai',  allowedHosts: ['yourdomain.com', 'localhost'],  rateLimit: { requests: 1000, window: '1m' },}); console.log(token.sanitizedKey); // kve_hb_...
List & revoke tokens
// List all tokensconst tokens = await kve.tokens.list(); // Revoke a tokenawait kve.tokens.revoke(token.id);

Python SDK

Install
pip install keyvault-edge
Usage
from keyvault_edge import KeyVaultEdgeimport os kve = KeyVaultEdge(api_key=os.environ["KVE_API_KEY"]) token = kve.tokens.create(    name="openai-prod",    real_key=os.environ["OPENAI_API_KEY"],    provider="openai",    allowed_hosts=["yourdomain.com", "localhost"],) print(token.sanitized_key)  # kve_hb_...

REST API

All SDK methods map 1:1 to REST endpoints. Base URL: https://api.keyvaultedge.com/v1. Authenticate with Authorization: Bearer YOUR_KVE_API_KEY.

POST/tokens
GET/tokens
GET/tokens/:id
DELETE/tokens/:id
GET/keys
POST/keys
DELETE/keys/:id

Webhooks

KeyVault Edge sends webhook events to your configured endpoint for breach events, quota alerts, and token lifecycle changes.

breach.detectedToken used from unauthorized host
quota.threshold_reachedUsage crossed 80% of plan limit
token.revokedToken was revoked (programmatic or manual)
token.expiredToken passed its expiry date