POST /api/v1/keys

Self-serve your own API key

Generates a high-entropy API key (secrets.token_urlsafe). The plaintext token is returned ONCE in the data envelope; Redis stores only the sha256 hash under apikey:<hash> (with a TTL), never the plaintext. A valid key in the X-API-Key header raises the rate limit (keyed tier). The endpoint itself is strictly rate-limited per IP to prevent key flooding. Validity is rolling: a key expires only after 30 days of non-use, and every use extends it back to 30 days.

Parameters

This endpoint takes no parameters.

Code samples

curl -X POST "https://infranode.dev/api/v1/keys" \
  -H "Content-Type: application/json"

const res = await fetch("https://infranode.dev/api/v1/keys", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
});
const data = await res.json();
console.log(data);

import httpx

res = httpx.post("https://infranode.dev/api/v1/keys")
res.raise_for_status()
print(res.json())

Try it

No live console is available for this endpoint. It is an operational or demo operation (for example a forced error or key mint) and is only documented here. Use the code samples above to call it directly.