Keys

Delete key

Delete an inference key with a management key. Requests with it fail from then on.

DELhttps://api.numes.ai/api/v1/keys/{hash}

Deletion is permanent; the key's usage history remains in Activity. To stop a key temporarily, use Update key with disabled: true instead.

Authorization

AuthorizationheaderRequired

Bearer management key. Management keys manage inference keys and cannot run inference. Authorization: Bearer $NUMES_MANAGEMENT_KEY

Headers

X-Request-Idstring: Correlation ID, not an idempotency key. Inference request IDs recorded with a generation are unique per account. A traffic-admitted request reusing a recorded ID returns 400 invalid_request. Traffic admission rejection takes precedence over this conflict, including for reused IDs; it performs no generation lookup and writes no generation, result or attempt. Rate-limit rejection returns 429 rate_limited with Retry-After; an inference limiter outage retains 500 server.
Length1–128

Path parameters

hashstringRequired: Pattern^[a-f0-9]{64}$

Responses

200Deletion resultapplication/json

BodyDeleteKeyResponseapplication/json

deletedbooleanRequired: Valuetrue

ErrorCompatible error envelopeapplication/json

Headers

X-Request-Idstring: Correlation identifier assigned or accepted by the service.
Retry-Afterinteger: Optional delay in seconds for retryable rate or availability errors.
Range≥ 1

BodyErrorResponseapplication/json

errorobjectRequired

Show3 child attributes

codeintegerRequired
messagestringRequired
metadataobject

openrouter_metadataobject

curl -X DELETE "https://api.numes.ai/api/v1/keys/5d41402abc4b2a76b9719d911017c592ae2f5e8f5d9c4b1e0a3f6e7d8c9b0a1f" \  -H "Authorization: Bearer $NUMES_MANAGEMENT_KEY"

Response

{ "deleted": true }