APITelemetry

Create an ingest key

Create an ingest key. Returns the full token once.

POST
/ingest-keys

Create an ingest key. Returns the full token once.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

manage_ingest_keys

Request Body

application/json
  1. body
name*string
Length1 <= length <= 255

Response Body

The request has succeeded and a new resource has been created as a result.

application/json
  1. 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*string

The full ingest key. Shown only once.

endpoint*string

OTLP base endpoint; clients append the provider segment, e.g. /claude.

Formaturi
curl -X POST "https://example.com/ingest-keys" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "key": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "last_four": "string",    "created_at": "2019-08-24T14:15:22Z"  },  "token": "string",  "endpoint": "http://example.com"}