FirecaseFirecase
Log inGet started
DocumentationAPI ReferenceErrorsGuides

POST /v1/internal/probes/api-key/issue

Mint (or rotate) the probe-runner's API key.

Returns plaintext exactly once — the caller must persist it in memory (the runner does this in ProbeContext) and re-issue on startup or before expires_at. Subsequent calls revoke any prior active probe-runner key in the same transaction.

Emits LifecycleAction::ProbeApiKeyIssued so an operator can reconstruct rotation events from the audit feed + SSE.

Tags: probes

Responses

200

JSON
{
  "$ref": "#/components/schemas/IssueProbeApiKeyResponse"
}

500 — INTERNAL_ERROR — DB or transaction failure

Code samples

TypeScript

TypeScript
import { firecase } from "@firecase/sdk";

const result = await firecase.post("/internal/probes/api-key/issue", { /* body */ });
console.log(result);

Python

Python
import firecase

result = firecase.post("/internal/probes/api-key/issue", json={})
print(result)

curl

Bash
curl -X POST https://api.firecase.ai/v1/internal/probes/api-key/issue \
  -H "Authorization: Bearer $FIRECASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'