Ingest Usage Events
curl --request POST \
--url https://api.example.com/api/v1/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_started_at": "2023-11-07T05:31:56Z",
"occurred_at": "2023-11-07T05:31:56Z",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key_id": "<string>",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requested_model_id": "<string>",
"requested_capabilities": [],
"model_id": "<string>",
"bundle_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"input_tokens": 1073741823,
"output_tokens": 1073741823,
"cost_usd": "<string>",
"max_output_tokens": 1073741824,
"latency_ms": 1073741823,
"stream": true,
"token_usage_source": "not_applicable",
"schema_version": 1,
"attempt_started_at": null,
"provider_id": "",
"cost_input_usd": "0",
"cost_output_usd": "0",
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"status": "denied",
"credential_id": null,
"credential_scope": null
}
]
'import requests
url = "https://api.example.com/api/v1/events"
payload = [
{
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_started_at": "2023-11-07T05:31:56Z",
"occurred_at": "2023-11-07T05:31:56Z",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key_id": "<string>",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requested_model_id": "<string>",
"requested_capabilities": [],
"model_id": "<string>",
"bundle_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"input_tokens": 1073741823,
"output_tokens": 1073741823,
"cost_usd": "<string>",
"max_output_tokens": 1073741824,
"latency_ms": 1073741823,
"stream": True,
"token_usage_source": "not_applicable",
"schema_version": 1,
"attempt_started_at": None,
"provider_id": "",
"cost_input_usd": "0",
"cost_output_usd": "0",
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"status": "denied",
"credential_id": None,
"credential_scope": None
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
event_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
request_started_at: '2023-11-07T05:31:56Z',
occurred_at: '2023-11-07T05:31:56Z',
org_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
workspace_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
key_id: '<string>',
user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
requested_model_id: '<string>',
requested_capabilities: [],
model_id: '<string>',
bundle_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
input_tokens: 1073741823,
output_tokens: 1073741823,
cost_usd: '<string>',
max_output_tokens: 1073741824,
latency_ms: 1073741823,
stream: true,
token_usage_source: 'not_applicable',
schema_version: 1,
attempt_started_at: null,
provider_id: '',
cost_input_usd: '0',
cost_output_usd: '0',
cache_read_tokens: 0,
cache_write_tokens: 0,
status: 'denied',
credential_id: null,
credential_scope: null
}
])
};
fetch('https://api.example.com/api/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/events",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'event_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'request_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'request_started_at' => '2023-11-07T05:31:56Z',
'occurred_at' => '2023-11-07T05:31:56Z',
'org_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'workspace_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'key_id' => '<string>',
'user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'requested_model_id' => '<string>',
'requested_capabilities' => [
],
'model_id' => '<string>',
'bundle_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'input_tokens' => 1073741823,
'output_tokens' => 1073741823,
'cost_usd' => '<string>',
'max_output_tokens' => 1073741824,
'latency_ms' => 1073741823,
'stream' => true,
'token_usage_source' => 'not_applicable',
'schema_version' => 1,
'attempt_started_at' => null,
'provider_id' => '',
'cost_input_usd' => '0',
'cost_output_usd' => '0',
'cache_read_tokens' => 0,
'cache_write_tokens' => 0,
'status' => 'denied',
'credential_id' => null,
'credential_scope' => null
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/events"
payload := strings.NewReader("[\n {\n \"event_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_started_at\": \"2023-11-07T05:31:56Z\",\n \"occurred_at\": \"2023-11-07T05:31:56Z\",\n \"org_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workspace_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"key_id\": \"<string>\",\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requested_model_id\": \"<string>\",\n \"requested_capabilities\": [],\n \"model_id\": \"<string>\",\n \"bundle_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"input_tokens\": 1073741823,\n \"output_tokens\": 1073741823,\n \"cost_usd\": \"<string>\",\n \"max_output_tokens\": 1073741824,\n \"latency_ms\": 1073741823,\n \"stream\": true,\n \"token_usage_source\": \"not_applicable\",\n \"schema_version\": 1,\n \"attempt_started_at\": null,\n \"provider_id\": \"\",\n \"cost_input_usd\": \"0\",\n \"cost_output_usd\": \"0\",\n \"cache_read_tokens\": 0,\n \"cache_write_tokens\": 0,\n \"status\": \"denied\",\n \"credential_id\": null,\n \"credential_scope\": null\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/events")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"event_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_started_at\": \"2023-11-07T05:31:56Z\",\n \"occurred_at\": \"2023-11-07T05:31:56Z\",\n \"org_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workspace_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"key_id\": \"<string>\",\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requested_model_id\": \"<string>\",\n \"requested_capabilities\": [],\n \"model_id\": \"<string>\",\n \"bundle_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"input_tokens\": 1073741823,\n \"output_tokens\": 1073741823,\n \"cost_usd\": \"<string>\",\n \"max_output_tokens\": 1073741824,\n \"latency_ms\": 1073741823,\n \"stream\": true,\n \"token_usage_source\": \"not_applicable\",\n \"schema_version\": 1,\n \"attempt_started_at\": null,\n \"provider_id\": \"\",\n \"cost_input_usd\": \"0\",\n \"cost_output_usd\": \"0\",\n \"cache_read_tokens\": 0,\n \"cache_write_tokens\": 0,\n \"status\": \"denied\",\n \"credential_id\": null,\n \"credential_scope\": null\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/events")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"event_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_started_at\": \"2023-11-07T05:31:56Z\",\n \"occurred_at\": \"2023-11-07T05:31:56Z\",\n \"org_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workspace_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"key_id\": \"<string>\",\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requested_model_id\": \"<string>\",\n \"requested_capabilities\": [],\n \"model_id\": \"<string>\",\n \"bundle_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"input_tokens\": 1073741823,\n \"output_tokens\": 1073741823,\n \"cost_usd\": \"<string>\",\n \"max_output_tokens\": 1073741824,\n \"latency_ms\": 1073741823,\n \"stream\": true,\n \"token_usage_source\": \"not_applicable\",\n \"schema_version\": 1,\n \"attempt_started_at\": null,\n \"provider_id\": \"\",\n \"cost_input_usd\": \"0\",\n \"cost_output_usd\": \"0\",\n \"cache_read_tokens\": 0,\n \"cache_write_tokens\": 0,\n \"status\": \"denied\",\n \"credential_id\": null,\n \"credential_scope\": null\n }\n]"
response = http.request(request)
puts response.read_body{
"data": {
"received": 123,
"ingested": 123,
"rejected": 123
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Synchronization
Ingest Usage Events
Ingest up to 1,000 usage events, skipping unauthorized or semantically invalid events.
Required permission: usage.ingest.
POST
/
api
/
v1
/
events
Ingest Usage Events
curl --request POST \
--url https://api.example.com/api/v1/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_started_at": "2023-11-07T05:31:56Z",
"occurred_at": "2023-11-07T05:31:56Z",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key_id": "<string>",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requested_model_id": "<string>",
"requested_capabilities": [],
"model_id": "<string>",
"bundle_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"input_tokens": 1073741823,
"output_tokens": 1073741823,
"cost_usd": "<string>",
"max_output_tokens": 1073741824,
"latency_ms": 1073741823,
"stream": true,
"token_usage_source": "not_applicable",
"schema_version": 1,
"attempt_started_at": null,
"provider_id": "",
"cost_input_usd": "0",
"cost_output_usd": "0",
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"status": "denied",
"credential_id": null,
"credential_scope": null
}
]
'import requests
url = "https://api.example.com/api/v1/events"
payload = [
{
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"request_started_at": "2023-11-07T05:31:56Z",
"occurred_at": "2023-11-07T05:31:56Z",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key_id": "<string>",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requested_model_id": "<string>",
"requested_capabilities": [],
"model_id": "<string>",
"bundle_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"input_tokens": 1073741823,
"output_tokens": 1073741823,
"cost_usd": "<string>",
"max_output_tokens": 1073741824,
"latency_ms": 1073741823,
"stream": True,
"token_usage_source": "not_applicable",
"schema_version": 1,
"attempt_started_at": None,
"provider_id": "",
"cost_input_usd": "0",
"cost_output_usd": "0",
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"status": "denied",
"credential_id": None,
"credential_scope": None
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
event_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
request_started_at: '2023-11-07T05:31:56Z',
occurred_at: '2023-11-07T05:31:56Z',
org_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
workspace_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
key_id: '<string>',
user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
requested_model_id: '<string>',
requested_capabilities: [],
model_id: '<string>',
bundle_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
input_tokens: 1073741823,
output_tokens: 1073741823,
cost_usd: '<string>',
max_output_tokens: 1073741824,
latency_ms: 1073741823,
stream: true,
token_usage_source: 'not_applicable',
schema_version: 1,
attempt_started_at: null,
provider_id: '',
cost_input_usd: '0',
cost_output_usd: '0',
cache_read_tokens: 0,
cache_write_tokens: 0,
status: 'denied',
credential_id: null,
credential_scope: null
}
])
};
fetch('https://api.example.com/api/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/events",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'event_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'request_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'request_started_at' => '2023-11-07T05:31:56Z',
'occurred_at' => '2023-11-07T05:31:56Z',
'org_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'workspace_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'key_id' => '<string>',
'user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'requested_model_id' => '<string>',
'requested_capabilities' => [
],
'model_id' => '<string>',
'bundle_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'input_tokens' => 1073741823,
'output_tokens' => 1073741823,
'cost_usd' => '<string>',
'max_output_tokens' => 1073741824,
'latency_ms' => 1073741823,
'stream' => true,
'token_usage_source' => 'not_applicable',
'schema_version' => 1,
'attempt_started_at' => null,
'provider_id' => '',
'cost_input_usd' => '0',
'cost_output_usd' => '0',
'cache_read_tokens' => 0,
'cache_write_tokens' => 0,
'status' => 'denied',
'credential_id' => null,
'credential_scope' => null
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/events"
payload := strings.NewReader("[\n {\n \"event_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_started_at\": \"2023-11-07T05:31:56Z\",\n \"occurred_at\": \"2023-11-07T05:31:56Z\",\n \"org_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workspace_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"key_id\": \"<string>\",\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requested_model_id\": \"<string>\",\n \"requested_capabilities\": [],\n \"model_id\": \"<string>\",\n \"bundle_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"input_tokens\": 1073741823,\n \"output_tokens\": 1073741823,\n \"cost_usd\": \"<string>\",\n \"max_output_tokens\": 1073741824,\n \"latency_ms\": 1073741823,\n \"stream\": true,\n \"token_usage_source\": \"not_applicable\",\n \"schema_version\": 1,\n \"attempt_started_at\": null,\n \"provider_id\": \"\",\n \"cost_input_usd\": \"0\",\n \"cost_output_usd\": \"0\",\n \"cache_read_tokens\": 0,\n \"cache_write_tokens\": 0,\n \"status\": \"denied\",\n \"credential_id\": null,\n \"credential_scope\": null\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/events")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"event_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_started_at\": \"2023-11-07T05:31:56Z\",\n \"occurred_at\": \"2023-11-07T05:31:56Z\",\n \"org_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workspace_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"key_id\": \"<string>\",\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requested_model_id\": \"<string>\",\n \"requested_capabilities\": [],\n \"model_id\": \"<string>\",\n \"bundle_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"input_tokens\": 1073741823,\n \"output_tokens\": 1073741823,\n \"cost_usd\": \"<string>\",\n \"max_output_tokens\": 1073741824,\n \"latency_ms\": 1073741823,\n \"stream\": true,\n \"token_usage_source\": \"not_applicable\",\n \"schema_version\": 1,\n \"attempt_started_at\": null,\n \"provider_id\": \"\",\n \"cost_input_usd\": \"0\",\n \"cost_output_usd\": \"0\",\n \"cache_read_tokens\": 0,\n \"cache_write_tokens\": 0,\n \"status\": \"denied\",\n \"credential_id\": null,\n \"credential_scope\": null\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/events")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"event_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"request_started_at\": \"2023-11-07T05:31:56Z\",\n \"occurred_at\": \"2023-11-07T05:31:56Z\",\n \"org_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workspace_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"key_id\": \"<string>\",\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requested_model_id\": \"<string>\",\n \"requested_capabilities\": [],\n \"model_id\": \"<string>\",\n \"bundle_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"input_tokens\": 1073741823,\n \"output_tokens\": 1073741823,\n \"cost_usd\": \"<string>\",\n \"max_output_tokens\": 1073741824,\n \"latency_ms\": 1073741823,\n \"stream\": true,\n \"token_usage_source\": \"not_applicable\",\n \"schema_version\": 1,\n \"attempt_started_at\": null,\n \"provider_id\": \"\",\n \"cost_input_usd\": \"0\",\n \"cost_output_usd\": \"0\",\n \"cache_read_tokens\": 0,\n \"cache_write_tokens\": 0,\n \"status\": \"denied\",\n \"credential_id\": null,\n \"credential_scope\": null\n }\n]"
response = http.request(request)
puts response.read_body{
"data": {
"received": 123,
"ingested": 123,
"rejected": 123
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
ManagementKeySessionCookie
A control-plane management key using the sk-cp- prefix. Inference keys are not accepted by control-plane endpoints.
Body
application/json
Maximum array length:
1000- DeniedUsageEventV1
- RoutedUsageEventV1
Idempotency key for event ingestion
Data-plane request ID
Timestamp when the logical request began
Timestamp when the attempt or denial completed
Organization that made the request
Workspace that made the request
Caller credential ID used for the request
Required string length:
1 - 255Whether the request came from an inference key or a Playground session
Available options:
inference_key, playground Principal that owned the caller credential when the request was made
Original caller-requested model before routing and fallback
Required string length:
1 - 255Original request capabilities before reconciliation
Available options:
tools, reasoning, structured_output Caller-facing model ID
Required string length:
1 - 255Policy bundle used for the request
Total input tokens
Required range:
0 <= x <= 2147483647Total output tokens
Required range:
0 <= x <= 2147483647Total estimated cost in USD
Pattern:
^\d+(?:\.\d+)?$Effective upstream output-token limit
Required range:
1 <= x <= 2147483647Gateway latency in milliseconds: per attempt when routed, end-to-end for a denial before routing
Required range:
0 <= x <= 2147483647Whether the response was streamed
No upstream token usage for a request denied before routing
Allowed value:
"not_applicable"Usage event schema version
No provider attempt was made
No provider was selected before denial
Allowed value:
""Estimated input cost in USD
Pattern:
^\d+(?:\.\d+)?$Estimated output cost in USD
Pattern:
^\d+(?:\.\d+)?$Input tokens read from a provider cache
Required range:
0 <= x <= 2147483647Input tokens written to a provider cache
Required range:
0 <= x <= 2147483647The request was denied before routing
Allowed value:
"denied"No provider credential was selected before denial
No provider credential scope was selected before denial
Response
Successful Response
Show child attributes
Show child attributes