APITelemetry
Create an ingest key
Create an ingest key. Returns the full token once.
POST
Create an ingest key. Returns the full token once.
ApiKeyAuthheader
AuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
manage_ingest_keysapplication/json- body
name*stringLength
1 <= length <= 255agent?TelemetryAgentThe coding agent the key is for.
Value in
"claude_code""claude_cowork""codex""copilot_vscode""copilot_cli""gemini_cli"The request has succeeded and a new resource has been created as a result.
application/json- response
Response for ingest key creation, includes the full token.
key*An ingest key. Coding agents point their OpenTelemetry model-usage data (tokens, cost, sessions, requests) at the gateway using this key.
token*stringThe full ingest key. Shown only once.
endpoint*stringOTLP base endpoint; clients append the provider segment, e.g. /claude.
Format
uricurl -X POST 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/ingest-keys' \ -H 'Content-Type: application/json' \ -d '{ "name": "string"}'Example Response
{ "key": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "last_four": "string", "agent": "claude_code", "created_at": "2019-08-24T14:15:22Z", "last_used_at": "2019-08-24T14:15:22Z" }, "token": "string", "endpoint": "http://example.com"}