Skip to main content

/api/keys/*

API key registration for higher rate limits.

POST /api/keys/register​

Generate a Tier 1 API key (free).

curl -X POST https://api.ombra-net.com/api/keys/register \
  -H "Content-Type: application/json" \
  -d '{"tier": 1, "label": "my-app-prod"}'

Response:

{
  "id": "k_abc123",
  "key": "om_live_xxxxxxxxxxxxxxxx",
  "tier": 1,
  "label": "my-app-prod",
  "createdAt": 1735389942000
}

Save key — shown only once. Use in X-API-Key header on subsequent requests.

For Tier 2 (paid) keys, contact team@ombra-net.com.

GET /api/keys/me​

List your active keys (requires X-API-Key).

curl https://api.ombra-net.com/api/keys/me \
  -H "X-API-Key: om_live_xxxx"

Response: { "keys": [{ "id", "label", "tier", "createdAt", "lastUsedAt" }] }

DELETE /api/keys/:id​

Revoke a key.

curl -X DELETE https://api.ombra-net.com/api/keys/k_abc123 \
  -H "X-API-Key: om_live_xxxx"