Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.
Structured batch-level ingestion failures, if any.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Trajectory","description":"Train, evaluate, and deploy models with specs (benchmarks). Explore production learning in private beta.","colors":{"primary":"#64748B","light":"#94A3B8","dark":"#94A3B8"},"logo":{"light":"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026auto=format\u0026n=wBjAnw9KLOV2bmIV\u0026q=85\u0026s=2c5ba8f0dfba44dc30aedea2479b99f8","dark":"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026auto=format\u0026n=wBjAnw9KLOV2bmIV\u0026q=85\u0026s=2c5ba8f0dfba44dc30aedea2479b99f8","href":"/"},"favicon":"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026auto=format\u0026n=wBjAnw9KLOV2bmIV\u0026q=85\u0026s=2c5ba8f0dfba44dc30aedea2479b99f8","contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trajectory","hasAudioNarration":false,"actualSubdomain":"trajectory","customDomains":["docs.trajectory.ai"],"gitSource":{"type":"github","owner":"trajectorylabs","repo":"trajectory-platform","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae904a45041af246c50784a","collectionId":"fc00dcca-a4f9-48b8-b143-2d6e5c4bf27a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae904a45041af246c50784a"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae922c28002b7ff5ee341f8","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Reference","count":121},{"language":"default","tag":"Resources","count":118},{"language":"default","tag":"Agents","count":19},{"language":"default","tag":"Specs (benchmarks)","count":19},{"language":"default","tag":"Training","count":18},{"language":"default","tag":"Evaluations","count":11},{"language":"default","tag":"Trajectories","count":10},{"language":"default","tag":"Build and improve","count":9},{"language":"default","tag":"Deployments","count":7},{"language":"default","tag":"Spec (benchmark) submissions","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/telemetry/ingest-events","slug":"/api-reference/telemetry/ingest-events","pageMetadata":{"title":"Ingest telemetry events","description":"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.","deprecated":null,"version":null,"sidebarTitle":"Ingest events","openapi":"/openapi.json post /api/v1/telemetry/events","href":"/api-reference/telemetry/ingest-events","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Ingest telemetry events","description":"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.","deprecated":null,"version":null,"sidebarTitle":"Ingest events","openapi":"/openapi.json post /api/v1/telemetry/events","href":"/api-reference/telemetry/ingest-events","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["telemetry"],"summary":"Ingest telemetry events","operationId":"ingestTelemetryEvents","requestBody":"0578a042-9661-4eaa-94f7-3fcfb6c0ddf7","responses":{"200":"82925ac9-b2e5-4db1-87ce-47361105956b","207":"51580cc1-cdbb-43ad-b15b-520913c22a68","400":"020ee477-192a-44ba-9455-ef40dc044283","500":"a94a3b42-f62f-4415-b9f1-bd711ea0cab6","default":"6cc0d620-7b3a-4024-96e8-9ec46171a808"},"x-trajectory-visibility":"public","security":["809b2828-57a7-4c65-a2ed-e6c5c0e7bb02"],"description":"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.","x-mint":{"href":"/api-reference/telemetry/ingest-events"},"method":"post","type":"path","servers":["03f71d5c-dd55-4266-b51b-e878ead2e552"],"path":"/api/v1/telemetry/events","baseUrlOptions":["https://api.trajectory.ai"],"title":"Ingest telemetry events","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"events":{"items":{"properties":{"event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Event Id","description":"Caller-provided unique event id used for idempotency and deduplication.","isRequired":true,"uniqueKey":"events.items.[INDEX].event_id","typeLabel":"string"},"event_type":{"type":"string","maxLength":256,"minLength":1,"title":"Event Type","description":"Product-defined telemetry event name, such as 'tool_call' or 'user_accept'.","isRequired":true,"uniqueKey":"events.items.[INDEX].event_type","typeLabel":"string"},"timestamp":{"type":"string","minLength":1,"title":"Timestamp","description":"ISO 8601 timestamp for when the event occurred.","isRequired":true,"uniqueKey":"events.items.[INDEX].timestamp","typeLabel":"string"},"session_id":{"type":"string","maxLength":512,"minLength":1,"title":"Session Id","description":"Grouping key for a broader user session, eval run, or import job.","isRequired":true,"uniqueKey":"events.items.[INDEX].session_id","typeLabel":"string"},"source":{"type":"string","maxLength":128,"minLength":1,"title":"Source","description":"Application or service that produced the event.","isRequired":true,"uniqueKey":"events.items.[INDEX].source","typeLabel":"string"},"user_id":{"oneOf":[{"type":"string","title":"User Id","description":"End-user identifier from the caller's system, when available.","maxLength":512,"uniqueKey":"events.items.[INDEX].user_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"User Id","description":"End-user identifier from the caller's system, when available.","uniqueKey":"events.items.[INDEX].user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"events.items.[INDEX].user_id","typeLabel":"string | null"},"trajectory_id":{"oneOf":[{"type":"string","title":"Trajectory Id","description":"Stored trajectory ID returned by trajectory creation or upload, when known.","maxLength":512,"uniqueKey":"events.items.[INDEX].trajectory_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trajectory Id","description":"Stored trajectory ID returned by trajectory creation or upload, when known.","uniqueKey":"events.items.[INDEX].trajectory_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"events.items.[INDEX].trajectory_id","typeLabel":"string | null"},"trace_id":{"oneOf":[{"type":"string","title":"Trace Id","description":"Caller-owned correlation key shared by telemetry and its trajectory.","maxLength":512,"uniqueKey":"events.items.[INDEX].trace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trace Id","description":"Caller-owned correlation key shared by telemetry and its trajectory.","uniqueKey":"events.items.[INDEX].trace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"events.items.[INDEX].trace_id","typeLabel":"string | null"},"properties":{"additionalProperties":true,"type":"object","title":"Properties","description":"Event-specific JSON properties.","uniqueKey":"events.items.[INDEX].properties","typeLabel":"Properties · object"},"metadata":{"oneOf":[{"type":"object","title":"Metadata","description":"Additional context, such as application version or ingestion details.","additionalProperties":true,"uniqueKey":"events.items.[INDEX].metadata.oneOf.0","typeLabel":"Metadata · object"},{"type":"null","title":"Metadata","description":"Additional context, such as application version or ingestion details.","uniqueKey":"events.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"events.items.[INDEX].metadata","typeLabel":"Metadata · object | null"}},"type":"object","required":["event_id","event_type","timestamp","session_id","source"],"title":"TelemetryEventIngestRequest","uniqueKey":"events.items.[INDEX]","typeLabel":"TelemetryEventIngestRequest · object"},"type":"array","maxItems":100000,"minItems":1,"title":"Events","description":"Telemetry events to ingest.","isRequired":true,"uniqueKey":"events","typeLabel":"TelemetryEventIngestRequest · object[]"}},"type":"object","required":["events"],"title":"TelemetryEventsIngestRequest","uniqueKey":"","typeLabel":"TelemetryEventsIngestRequest · object"},"examples":{"Example":{"title":"Example","value":{"events":[{"event_id":"\u003cstring>","event_type":"\u003cstring>","timestamp":"\u003cstring>","session_id":"\u003cstring>","source":"\u003cstring>","user_id":"\u003cstring>","trajectory_id":"\u003cstring>","trace_id":"\u003cstring>","properties":{},"metadata":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"82925ac9-b2e5-4db1-87ce-47361105956b":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"ingested":{"type":"integer","title":"Ingested","description":"Number of telemetry events accepted for ingestion.","isRequired":true,"uniqueKey":"ingested","typeLabel":"integer"},"skipped":{"type":"integer","title":"Skipped","description":"Number of telemetry events skipped by validation.","default":0,"uniqueKey":"skipped","typeLabel":"integer"},"failures":{"items":{"properties":{"code":{"type":"string","title":"Code","description":"Stable programmatic reason for this item failure.","isRequired":true,"uniqueKey":"failures.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"Human-readable explanation for this item occurrence.","isRequired":true,"uniqueKey":"failures.items.[INDEX].message","typeLabel":"string"},"item_index":{"oneOf":[{"type":"integer","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"failures.items.[INDEX].item_index.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"failures.items.[INDEX].item_index.oneOf.1","typeLabel":"null"}],"uniqueKey":"failures.items.[INDEX].item_index","typeLabel":"integer | null"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Machine-readable values specific to this failure code.","uniqueKey":"failures.items.[INDEX].context","typeLabel":"Context · object"}},"type":"object","required":["code","message"],"title":"BatchItemFailure","uniqueKey":"failures.items.[INDEX]","typeLabel":"BatchItemFailure · object"},"type":"array","title":"Failures","description":"Structured batch-level ingestion failures, if any.","uniqueKey":"failures","typeLabel":"BatchItemFailure · object[]"}},"type":"object","required":["ingested"],"title":"TelemetryEventsIngestResponse","uniqueKey":"","typeLabel":"TelemetryEventsIngestResponse · object"},"examples":{"Example":{"title":"Example","value":{"ingested":123,"skipped":0,"failures":[{"code":"\u003cstring>","message":"\u003cstring>","item_index":123,"context":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"51580cc1-cdbb-43ad-b15b-520913c22a68":{"description":"Some telemetry event batches were accepted, but one or more failed.","content":{"application/json":{"schema":{"properties":{"ingested":{"type":"integer","title":"Ingested","description":"Number of telemetry events accepted for ingestion.","isRequired":true,"uniqueKey":"ingested","typeLabel":"integer"},"skipped":{"type":"integer","title":"Skipped","description":"Number of telemetry events skipped by validation.","default":0,"uniqueKey":"skipped","typeLabel":"integer"},"failures":{"items":{"properties":{"code":{"type":"string","title":"Code","description":"Stable programmatic reason for this item failure.","isRequired":true,"uniqueKey":"failures.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"Human-readable explanation for this item occurrence.","isRequired":true,"uniqueKey":"failures.items.[INDEX].message","typeLabel":"string"},"item_index":{"oneOf":[{"type":"integer","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"failures.items.[INDEX].item_index.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"failures.items.[INDEX].item_index.oneOf.1","typeLabel":"null"}],"uniqueKey":"failures.items.[INDEX].item_index","typeLabel":"integer | null"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Machine-readable values specific to this failure code.","uniqueKey":"failures.items.[INDEX].context","typeLabel":"Context · object"}},"type":"object","required":["code","message"],"title":"BatchItemFailure","uniqueKey":"failures.items.[INDEX]","typeLabel":"BatchItemFailure · object"},"type":"array","title":"Failures","description":"Structured batch-level ingestion failures, if any.","uniqueKey":"failures","typeLabel":"BatchItemFailure · object[]"}},"type":"object","required":["ingested"],"title":"TelemetryEventsIngestResponse","uniqueKey":"","typeLabel":"TelemetryEventsIngestResponse · object"},"examples":{"Example":{"title":"Example","value":{"ingested":123,"skipped":0,"failures":[{"code":"\u003cstring>","message":"\u003cstring>","item_index":123,"context":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"020ee477-192a-44ba-9455-ef40dc044283":{"description":"No telemetry events were accepted because an event is invalid.","headers":{"X-Request-ID":{"schema":{"type":"string"}},"Trajectory-Should-Retry":{"schema":{"type":"boolean"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","const":"invalid_request_error","title":"Type","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","const":"invalid_telemetry_event","title":"Code","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","title":"Doc Url","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"context":{"properties":{"failures":{"items":{"properties":{"code":{"type":"string","title":"Code","description":"Stable programmatic reason for this item failure.","isRequired":true,"uniqueKey":"error.context.failures.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"Human-readable explanation for this item occurrence.","isRequired":true,"uniqueKey":"error.context.failures.items.[INDEX].message","typeLabel":"string"},"item_index":{"oneOf":[{"type":"integer","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"error.context.failures.items.[INDEX].item_index.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"error.context.failures.items.[INDEX].item_index.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.context.failures.items.[INDEX].item_index","typeLabel":"integer | null"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Machine-readable values specific to this failure code.","uniqueKey":"error.context.failures.items.[INDEX].context","typeLabel":"Context · object"}},"type":"object","required":["code","message"],"title":"BatchItemFailure","uniqueKey":"error.context.failures.items.[INDEX]","typeLabel":"BatchItemFailure · object"},"type":"array","title":"Failures","isRequired":true,"uniqueKey":"error.context.failures","typeLabel":"BatchItemFailure · object[]"}},"additionalProperties":false,"type":"object","required":["failures"],"title":"TelemetryIngestionFailureContext","isRequired":true,"uniqueKey":"error.context","typeLabel":"TelemetryIngestionFailureContext · object"},"param":{"oneOf":[{"type":"string","title":"Param","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","doc_url","context"],"title":"InvalidTelemetryEventErrorBody","isRequired":true,"uniqueKey":"error","typeLabel":"InvalidTelemetryEventErrorBody · object"}},"type":"object","required":["error"],"title":"InvalidTelemetryEventErrorResponse","uniqueKey":"","typeLabel":"InvalidTelemetryEventErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"invalid_telemetry_event","message":"\u003cstring>","doc_url":"\u003cstring>","context":{"failures":[{"code":"\u003cstring>","message":"\u003cstring>","item_index":123,"context":{}}]},"param":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a94a3b42-f62f-4415-b9f1-bd711ea0cab6":{"description":"No telemetry events were accepted because storage failed.","headers":{"X-Request-ID":{"schema":{"type":"string"}},"Trajectory-Should-Retry":{"schema":{"type":"boolean"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","const":"api_error","title":"Type","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","const":"telemetry_ingestion_failed","title":"Code","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","title":"Doc Url","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"context":{"properties":{"failures":{"items":{"properties":{"code":{"type":"string","title":"Code","description":"Stable programmatic reason for this item failure.","isRequired":true,"uniqueKey":"error.context.failures.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"Human-readable explanation for this item occurrence.","isRequired":true,"uniqueKey":"error.context.failures.items.[INDEX].message","typeLabel":"string"},"item_index":{"oneOf":[{"type":"integer","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"error.context.failures.items.[INDEX].item_index.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Item Index","description":"Zero-based input index when the failed item came from a list.","uniqueKey":"error.context.failures.items.[INDEX].item_index.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.context.failures.items.[INDEX].item_index","typeLabel":"integer | null"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Machine-readable values specific to this failure code.","uniqueKey":"error.context.failures.items.[INDEX].context","typeLabel":"Context · object"}},"type":"object","required":["code","message"],"title":"BatchItemFailure","uniqueKey":"error.context.failures.items.[INDEX]","typeLabel":"BatchItemFailure · object"},"type":"array","title":"Failures","isRequired":true,"uniqueKey":"error.context.failures","typeLabel":"BatchItemFailure · object[]"}},"additionalProperties":false,"type":"object","required":["failures"],"title":"TelemetryIngestionFailureContext","isRequired":true,"uniqueKey":"error.context","typeLabel":"TelemetryIngestionFailureContext · object"},"param":{"oneOf":[{"type":"string","title":"Param","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","doc_url","context"],"title":"TelemetryIngestionFailedErrorBody","isRequired":true,"uniqueKey":"error","typeLabel":"TelemetryIngestionFailedErrorBody · object"}},"type":"object","required":["error"],"title":"TelemetryIngestionFailedErrorResponse","uniqueKey":"","typeLabel":"TelemetryIngestionFailedErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"api_error","code":"telemetry_ingestion_failed","message":"\u003cstring>","doc_url":"\u003cstring>","context":{"failures":[{"code":"\u003cstring>","message":"\u003cstring>","item_index":123,"context":{}}]},"param":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6cc0d620-7b3a-4024-96e8-9ec46171a808":{"description":"Common API error. Possible codes: `authentication_required`, `permission_denied`, `validation_error`, `rate_limited`, `internal_error`, `service_unavailable`.","headers":{"X-Request-ID":{"schema":{"type":"string"}},"Trajectory-Should-Retry":{"schema":{"type":"boolean"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"enum":["invalid_request_error","authentication_error","permission_error","conflict_error","billing_error","rate_limit_error","dependency_error","api_error"],"title":"ErrorType","type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"doc_url":{"type":"string","title":"Doc Url","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"context":{"additionalProperties":true,"title":"Context","type":"object","isRequired":true,"uniqueKey":"error.context","typeLabel":"Context · object"},"param":{"oneOf":[{"type":"string","title":"Param","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"required":["type","code","message","doc_url","context"],"title":"ApiErrorBody","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ApiErrorBody · object"}},"required":["error"],"title":"ApiErrorEnvelope","type":"object","uniqueKey":"","typeLabel":"ApiErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"\u003cstring>","message":"\u003cstring>","doc_url":"\u003cstring>","context":{},"param":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"809b2828-57a7-4c65-a2ed-e6c5c0e7bb02":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Organization API key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"03f71d5c-dd55-4266-b51b-e878ead2e552":{"url":"https://api.trajectory.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Organization API key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"Organization API key","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"trajectory","siteName":"Trajectory","title":"Ingest telemetry events - Trajectory","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T21:11:22.799Z","originalFileLocation":"api-reference/telemetry/ingest-events.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trajectory\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/svg+xml\" sizes=\"180x180\" href=\"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026amp;auto=format\u0026amp;n=wBjAnw9KLOV2bmIV\u0026amp;q=85\u0026amp;s=2c5ba8f0dfba44dc30aedea2479b99f8\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"32x32\" href=\"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026amp;auto=format\u0026amp;n=wBjAnw9KLOV2bmIV\u0026amp;q=85\u0026amp;s=2c5ba8f0dfba44dc30aedea2479b99f8\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"16x16\" href=\"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026amp;auto=format\u0026amp;n=wBjAnw9KLOV2bmIV\u0026amp;q=85\u0026amp;s=2c5ba8f0dfba44dc30aedea2479b99f8\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/svg+xml\" href=\"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026amp;auto=format\u0026amp;n=wBjAnw9KLOV2bmIV\u0026amp;q=85\u0026amp;s=2c5ba8f0dfba44dc30aedea2479b99f8\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ingest telemetry events - Trajectory\">\u003cmeta data-mint-head property=\"og:description\" content=\"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trajectory\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trajectory.mintlify.app/_mintlify/api/og/v2?division=Telemetry\u0026amp;title=Ingest+telemetry+events\u0026amp;description=Record+application+events+independently+of+trajectory+completion.+Use+stable+event+IDs+for+retry+deduplication+and+trajectory_id+to+link+known+trajectories.+Tel\u0026amp;theme=b321e16dbe8718ec6d9f5033\u0026amp;signature=bfd3479c383dc3981ecb8143d12a23522e9defbb115ff0c7db5c69b6ca088159\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Ingest telemetry events - Trajectory\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trajectory.mintlify.app/_mintlify/api/og/v2?division=Telemetry\u0026amp;title=Ingest+telemetry+events\u0026amp;description=Record+application+events+independently+of+trajectory+completion.+Use+stable+event+IDs+for+retry+deduplication+and+trajectory_id+to+link+known+trajectories.+Tel\u0026amp;theme=b321e16dbe8718ec6d9f5033\u0026amp;signature=bfd3479c383dc3981ecb8143d12a23522e9defbb115ff0c7db5c69b6ca088159\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/trajectory/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trajectory\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#64748B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/telemetry/ingest-events.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trajectory.ai/#organization\",\"name\":\"Trajectory\",\"url\":\"https://docs.trajectory.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trajectory/wBjAnw9KLOV2bmIV/images/logo.svg?fit=max\u0026auto=format\u0026n=wBjAnw9KLOV2bmIV\u0026q=85\u0026s=2c5ba8f0dfba44dc30aedea2479b99f8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trajectory.ai#website\",\"name\":\"Trajectory\",\"url\":\"https://docs.trajectory.ai\",\"publisher\":{\"@id\":\"https://docs.trajectory.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events#webpage\",\"url\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events\",\"name\":\"Ingest telemetry events\",\"description\":\"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.\",\"dateModified\":\"2026-11-02T21:11:22.799Z\",\"isPartOf\":{\"@id\":\"https://docs.trajectory.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.trajectory.ai/pricing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resources\",\"item\":\"https://docs.trajectory.ai/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Ingest telemetry events\",\"item\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events#apireference\",\"headline\":\"Ingest telemetry events\",\"name\":\"Ingest telemetry events\",\"description\":\"Record application events independently of trajectory completion. Use stable event IDs for retry deduplication and trajectory_id to link known trajectories. Telemetry does not automatically become a training reward. Using these events for production learning, with or without an existing grader, requires private-beta access.\",\"url\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trajectory.ai/api-reference/telemetry/ingest-events#webpage\"},\"dateModified\":\"2026-11-02T21:11:22.799Z\",\"publisher\":{\"@id\":\"https://docs.trajectory.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trajectory.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trajectory\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trajectory","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Introduction","icon":"compass","href":"/introduction"},{"title":"Quickstart","icon":"bolt","href":"/quickstart"},{"title":"Core concepts","icon":"lightbulb","href":"/concepts"},{"title":"Authentication","icon":"key","href":"/authentication"},{"title":"Use the platform","icon":"rocket","href":"/platform"}]},{"group":"Build and improve","pages":[{"title":"Agents","href":"/agent"},{"title":"Bring your spec (benchmark)","href":"/guides/spec"},{"title":"Adapt an existing grader","href":"/guides/source-graders"},{"title":"Keep diagnostic files with a trajectory","href":"/guides/diagnostic-artifacts"},{"title":"Connect an Inspect harness","href":"/guides/inspect"},{"title":"Termination reasons","href":"/guides/termination-reasons"},{"title":"Evaluate and compare","href":"/guides/evaluations"},{"title":"Train a model","href":"/guides/training"},{"title":"Deploy and promote","href":"/guides/deployments"}]},{"group":"Production learning","tag":"Private beta","pages":[{"title":"Collect production traces","icon":"route","href":"/guides/production-traces"},{"title":"Record telemetry","icon":"signal-stream","href":"/guides/telemetry"}]},{"group":"Reference","pages":[{"title":"Models and pricing","href":"/pricing"},{"title":"Client reference","icon":"code","href":"/reference/client"},{"title":"Errors and retries","icon":"triangle-exclamation","href":"/reference/errors"},{"group":"Resources","pages":[{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"sidebarTitle":"List agents","openapi":"/openapi.json get /api/v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"sidebarTitle":"Create an agent","openapi":"/openapi.json post /api/v1/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"sidebarTitle":"Get an agent","openapi":"/openapi.json get /api/v1/agents/{agent_id}","href":"/api-reference/agents/get-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"sidebarTitle":"Delete an agent","openapi":"/openapi.json delete /api/v1/agents/{agent_id}","href":"/api-reference/agents/delete-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"sidebarTitle":"Update an agent","openapi":"/openapi.json patch /api/v1/agents/{agent_id}","href":"/api-reference/agents/update-an-agent"},{"title":"Get Agent By Name","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/name/{name}","href":"/api-reference/agents/get-agent-by-name"},{"title":"List Agent Benchmarks","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/benchmarks","href":"/api-reference/agents/list-agent-benchmarks"},{"title":"Delete Benchmark By Name","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/agents/{agent_id}/benchmarks","href":"/api-reference/agents/delete-benchmark-by-name"},{"title":"Get Benchmark By Name","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/benchmarks/latest","href":"/api-reference/agents/get-benchmark-by-name"},{"title":"List Benchmark Versions By Name","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/benchmarks/versions","href":"/api-reference/agents/list-benchmark-versions-by-name"},{"title":"List Agent Training Runs","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/training-runs","href":"/api-reference/agents/list-agent-training-runs"},{"title":"Attach Agent Training Run","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/training-runs","href":"/api-reference/agents/attach-agent-training-run"},{"title":"List Agent Evaluation Runs","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/evaluation-runs","href":"/api-reference/agents/list-agent-evaluation-runs"},{"title":"List Agent Deployments","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/deployments","href":"/api-reference/agents/list-agent-deployments"},{"title":"Get Agent Evaluation Run","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/evaluation-runs/{eval_run_id}","href":"/api-reference/agents/get-agent-evaluation-run"},{"title":"Get Agent Training Evaluation Series","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/training-runs/{training_run_id}/evaluation-series","href":"/api-reference/agents/get-agent-training-evaluation-series"},{"title":"List Production Traces","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/traces","href":"/api-reference/agents/list-production-traces"},{"title":"Get Production Trace","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/traces/{trajectory_id}","href":"/api-reference/agents/get-production-trace"},{"title":"Update Production Trace Feedback","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/agents/{agent_id}/traces/{trajectory_id}","href":"/api-reference/agents/update-production-trace-feedback"}]},{"group":"model-slugs","pages":[{"title":"Get Production Model Slug","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/model-slugs/production/{agent_id}","href":"/api-reference/model-slugs/get-production-model-slug"},{"title":"Create Production Model Slug","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/model-slugs/production/{agent_id}","href":"/api-reference/model-slugs/create-production-model-slug"},{"title":"Update Production Model Slug","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/model-slugs/production/{agent_id}","href":"/api-reference/model-slugs/update-production-model-slug"}]},{"group":"Trajectories","pages":[{"title":"List trajectories","deprecated":null,"version":null,"sidebarTitle":"List trajectories route","openapi":"/openapi.json get /api/v1/trajectories","href":"/api-reference/trajectories/list-trajectories-route"},{"title":"Create a trajectory","deprecated":null,"version":null,"sidebarTitle":"Create a trajectory","openapi":"/openapi.json post /api/v1/trajectories","href":"/api-reference/trajectories/create-a-trajectory"},{"title":"Upload trajectories","deprecated":null,"version":null,"sidebarTitle":"Upload","openapi":"/openapi.json post /api/v1/trajectories/upload","href":"/api-reference/trajectories/upload"},{"title":"List trajectory datasets","deprecated":null,"version":null,"sidebarTitle":"Datasets","openapi":"/openapi.json get /api/v1/datasets","href":"/api-reference/trajectories/datasets"},{"title":"List trajectory events","deprecated":null,"version":null,"sidebarTitle":"List trajectory events","openapi":"/openapi.json get /api/v1/trajectories/{trajectory_id}/events","href":"/api-reference/trajectories/list-trajectory-events"},{"title":"Record a trajectory event","deprecated":null,"version":null,"sidebarTitle":"Log trajectory event","openapi":"/openapi.json post /api/v1/trajectories/{trajectory_id}/events","href":"/api-reference/trajectories/log-trajectory-event"},{"title":"Record a trajectory reward","deprecated":null,"version":null,"sidebarTitle":"Log trajectory reward","openapi":"/openapi.json post /api/v1/trajectories/{trajectory_id}/rewards","href":"/api-reference/trajectories/log-trajectory-reward"},{"title":"Complete a trajectory","deprecated":null,"version":null,"sidebarTitle":"Complete trajectory route","openapi":"/openapi.json post /api/v1/trajectories/{trajectory_id}/complete","href":"/api-reference/trajectories/complete-trajectory-route"},{"title":"Get a trajectory","deprecated":null,"version":null,"sidebarTitle":"Detail","openapi":"/openapi.json get /api/v1/trajectories/{trajectory_id}","href":"/api-reference/trajectories/detail"},{"title":"List trajectory steps","deprecated":null,"version":null,"sidebarTitle":"Steps","openapi":"/openapi.json get /api/v1/trajectories/{trajectory_id}/steps","href":"/api-reference/trajectories/steps"}]},{"group":"Artifacts","pages":[{"title":"Store artifact content","deprecated":null,"version":null,"sidebarTitle":"Store artifact content","openapi":"/openapi.json post /api/v1/trajectories/{trajectory_id}/artifacts/content","href":"/api-reference/artifacts/store-artifact-content"},{"title":"Get an artifact download URL","deprecated":null,"version":null,"sidebarTitle":"Get an artifact download url","openapi":"/openapi.json get /api/v1/artifacts/{artifact_id}","href":"/api-reference/artifacts/get-an-artifact-download-url"},{"title":"Create an artifact upload","deprecated":null,"version":null,"sidebarTitle":"Create an artifact upload","openapi":"/openapi.json post /api/v1/trajectories/{trajectory_id}/artifacts","href":"/api-reference/artifacts/create-an-artifact-upload"},{"title":"Complete an artifact upload","deprecated":null,"version":null,"sidebarTitle":"Complete an artifact upload","openapi":"/openapi.json post /api/v1/trajectories/{trajectory_id}/artifacts/{artifact_id}/complete","href":"/api-reference/artifacts/complete-an-artifact-upload"}]},{"group":"Deployments","pages":[{"title":"Deployment Chat Completion","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/deploy/{deployment_id}/chat/completions","href":"/api-reference/deployments/deployment-chat-completion"},{"title":"List deployments","deprecated":null,"version":null,"sidebarTitle":"List deployments route","openapi":"/openapi.json get /api/v1/deploy","href":"/api-reference/deployments/list-deployments-route"},{"title":"Create a deployment","deprecated":null,"version":null,"sidebarTitle":"Start","openapi":"/openapi.json post /api/v1/deploy","href":"/api-reference/deployments/start"},{"title":"Retry Deployment Route","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/deploy/{deployment_id}/retry","href":"/api-reference/deployments/retry-deployment-route"},{"title":"Cancel Deployment Route","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/deploy/{deployment_id}/cancel","href":"/api-reference/deployments/cancel-deployment-route"},{"title":"Get a deployment","deprecated":null,"version":null,"sidebarTitle":"Get deployment route","openapi":"/openapi.json get /api/v1/deploy/{deployment_id}","href":"/api-reference/deployments/get-deployment-route"},{"title":"Delete a deployment","deprecated":null,"version":null,"sidebarTitle":"Undeploy","openapi":"/openapi.json delete /api/v1/deploy/{deployment_id}","href":"/api-reference/deployments/undeploy"}]},{"group":"Model endpoints","pages":[{"title":"Get Model Endpoint Route","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/model-endpoints/{production_model_slug}","href":"/api-reference/model-endpoints/get-model-endpoint-route"},{"title":"Create a model endpoint","deprecated":null,"version":null,"sidebarTitle":"Create a model endpoint","openapi":"/openapi.json post /api/v1/model-endpoints","href":"/api-reference/model-endpoints/create-a-model-endpoint"}]},{"group":"Supported models","pages":[{"title":"List training models","deprecated":null,"version":null,"sidebarTitle":"List supported training models","openapi":"/openapi.json get /api/v1/models/supported-training-models","href":"/api-reference/supported-models/list-supported-training-models"},{"title":"List evaluation models","deprecated":null,"version":null,"sidebarTitle":"List supported eval models","openapi":"/openapi.json get /api/v1/models/supported-eval-models","href":"/api-reference/supported-models/list-supported-eval-models"}]},{"group":"Inference","pages":[{"title":"Create a chat completion","deprecated":null,"version":null,"sidebarTitle":"Create chat completion 1","openapi":"/openapi.json post /v1/chat/completions","href":"/api-reference/inference/create-chat-completion-1"},{"title":"Create Response","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/responses","href":"/api-reference/inference/create-response"},{"title":"List served models","deprecated":null,"version":null,"sidebarTitle":"List models 1","openapi":"/openapi.json get /v1/models","href":"/api-reference/inference/list-models-1"},{"title":"Get a served model","deprecated":null,"version":null,"sidebarTitle":"Get model 1","openapi":"/openapi.json get /v1/models/{model}","href":"/api-reference/inference/get-model-1"},{"title":"Submit Inference Operation","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/inference/operations","href":"/api-reference/inference/submit-inference-operation"},{"title":"Get By Inference Operation","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/inference/operations/{inference_operation_id}","href":"/api-reference/inference/get-by-inference-operation"}]},{"group":"Organizations","pages":[{"title":"Get the current organization","deprecated":null,"version":null,"sidebarTitle":"Current organization","openapi":"/openapi.json get /api/v1/organizations/current","href":"/api-reference/organizations/current-organization"}]},{"group":"Secrets","pages":[{"title":"List secrets","deprecated":null,"version":null,"sidebarTitle":"List user secrets","openapi":"/openapi.json get /api/v1/secrets","href":"/api-reference/secrets/list-user-secrets"},{"title":"Create a secret","deprecated":null,"version":null,"sidebarTitle":"Create secret","openapi":"/openapi.json post /api/v1/secrets","href":"/api-reference/secrets/create-secret"},{"title":"Revoke a secret","deprecated":null,"version":null,"sidebarTitle":"Revoke secret","openapi":"/openapi.json delete /api/v1/secrets/{secret_id}","href":"/api-reference/secrets/revoke-secret"}]},{"group":"billing","pages":[{"title":"Get Billing Run Costs","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/billing/usage/runs","href":"/api-reference/billing/get-billing-run-costs"}]},{"group":"Specs (benchmarks)","pages":[{"title":"Get a spec (benchmark)","deprecated":null,"version":null,"sidebarTitle":"Benchmark spec","openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/spec","href":"/api-reference/benchmarks/benchmark-spec"},{"title":"List Benchmark Spec Tasks","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/tasks","href":"/api-reference/benchmarks/list-benchmark-spec-tasks"},{"title":"List Benchmark Spec Tools","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/tools","href":"/api-reference/benchmarks/list-benchmark-spec-tools"},{"title":"List Benchmark Spec Runtimes","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/runtimes","href":"/api-reference/benchmarks/list-benchmark-spec-runtimes"},{"title":"Get Benchmark Task Readiness","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/task-readiness","href":"/api-reference/benchmarks/get-benchmark-task-readiness"},{"title":"Get a spec (benchmark) task count","deprecated":null,"version":null,"sidebarTitle":"Benchmark task count","openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/task-count","href":"/api-reference/benchmarks/benchmark-task-count"},{"title":"Create a spec (benchmark) upload","deprecated":null,"version":null,"sidebarTitle":"Create benchmark upload","openapi":"/openapi.json post /api/v1/benchmarks/uploads","href":"/api-reference/benchmarks/create-benchmark-upload"},{"title":"Register a spec (benchmark) manifest","deprecated":null,"version":null,"sidebarTitle":"Ingest benchmark","openapi":"/openapi.json post /api/v1/benchmarks/{bench_id}/ingest","href":"/api-reference/benchmarks/ingest-benchmark"},{"title":"Compare spec (benchmark) tasks","deprecated":null,"version":null,"sidebarTitle":"Diff benchmark tasks","openapi":"/openapi.json post /api/v1/benchmarks/{bench_id}/tasks/diff","href":"/api-reference/benchmarks/diff-benchmark-tasks"},{"title":"Create a task append upload","deprecated":null,"version":null,"sidebarTitle":"Create benchmark task append","openapi":"/openapi.json post /api/v1/benchmarks/{bench_id}/tasks/append","href":"/api-reference/benchmarks/create-benchmark-task-append"},{"title":"Commit a task append","deprecated":null,"version":null,"sidebarTitle":"Commit benchmark task append","openapi":"/openapi.json post /api/v1/benchmarks/{bench_id}/tasks/append/{batch_id}/commit","href":"/api-reference/benchmarks/commit-benchmark-task-append"},{"title":"Build spec (benchmark) environments","deprecated":null,"version":null,"sidebarTitle":"Build benchmark images","openapi":"/openapi.json post /api/v1/benchmarks/{bench_id}/images/build","href":"/api-reference/benchmarks/build-benchmark-images"},{"title":"List spec (benchmark) images","deprecated":null,"version":null,"sidebarTitle":"List benchmark images","openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/images","href":"/api-reference/benchmarks/list-benchmark-images"},{"title":"Check spec (benchmark) readiness","deprecated":null,"version":null,"sidebarTitle":"Get benchmark readiness","openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}/readiness","href":"/api-reference/benchmarks/get-benchmark-readiness"},{"title":"List specs (benchmarks)","deprecated":null,"version":null,"sidebarTitle":"List benchmarks","openapi":"/openapi.json get /api/v1/benchmarks","href":"/api-reference/benchmarks/list-benchmarks"},{"title":"List spec (benchmark) runtimes","deprecated":null,"version":null,"sidebarTitle":"List benchmark runtimes","openapi":"/openapi.json get /api/v1/benchmarks/runtimes","href":"/api-reference/benchmarks/list-benchmark-runtimes"},{"title":"Get a spec (benchmark)","deprecated":null,"version":null,"sidebarTitle":"Get benchmark","openapi":"/openapi.json get /api/v1/benchmarks/{bench_id}","href":"/api-reference/benchmarks/get-benchmark"},{"title":"Delete a spec (benchmark)","deprecated":null,"version":null,"sidebarTitle":"Delete benchmark spec","openapi":"/openapi.json delete /api/v1/benchmarks/{bench_id}","href":"/api-reference/benchmarks/delete-benchmark-spec"},{"title":"Delete a spec (benchmark) task","deprecated":null,"version":null,"sidebarTitle":"Delete benchmark task","openapi":"/openapi.json delete /api/v1/benchmarks/{bench_id}/tasks/{task_id}","href":"/api-reference/benchmarks/delete-benchmark-task"}]},{"group":"Diagnostics","pages":[{"title":"Ingest Task For Diagnostics","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/diagnostics/task/ingest","href":"/api-reference/diagnostics/ingest-task-for-diagnostics"},{"title":"Start Task Diagnostics","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/diagnostics/task/run","href":"/api-reference/diagnostics/start-task-diagnostics"},{"title":"Start Benchmark Diagnostics","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/diagnostics/benchmark/run","href":"/api-reference/diagnostics/start-benchmark-diagnostics"},{"title":"Get Benchmark Diagnostics Status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/diagnostics/{benchmark_diagnostic_id}/status","href":"/api-reference/diagnostics/get-benchmark-diagnostics-status"},{"title":"Get Benchmark Diagnostics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/diagnostics/{benchmark_diagnostic_id}","href":"/api-reference/diagnostics/get-benchmark-diagnostics"}]},{"group":"Spec (benchmark) submissions","pages":[{"title":"Create a spec (benchmark) submission","deprecated":null,"version":null,"sidebarTitle":"Create session","openapi":"/openapi.json post /api/v1/benchmark-ingestion/sessions","href":"/api-reference/benchmark-ingestion/create-session"},{"title":"Allocate submission uploads","deprecated":null,"version":null,"sidebarTitle":"Allocate","openapi":"/openapi.json post /api/v1/benchmark-ingestion/sessions/{operation_id}/uploads","href":"/api-reference/benchmark-ingestion/allocate"},{"title":"Finalize a spec (benchmark) submission","deprecated":null,"version":null,"sidebarTitle":"Finalize","openapi":"/openapi.json post /api/v1/benchmark-ingestion/sessions/{operation_id}/finalize","href":"/api-reference/benchmark-ingestion/finalize"},{"title":"Cancel a spec (benchmark) upload","deprecated":null,"version":null,"sidebarTitle":"Cancel","openapi":"/openapi.json post /api/v1/benchmark-ingestion/sessions/{operation_id}/cancel","href":"/api-reference/benchmark-ingestion/cancel"},{"title":"Get submission progress","deprecated":null,"version":null,"sidebarTitle":"Status","openapi":"/openapi.json get /api/v1/benchmark-ingestion/operations/{operation_id}","href":"/api-reference/benchmark-ingestion/status"},{"title":"List submission results","deprecated":null,"version":null,"sidebarTitle":"Items","openapi":"/openapi.json get /api/v1/benchmark-ingestion/operations/{operation_id}/{kind}","href":"/api-reference/benchmark-ingestion/items"}]},{"group":"Evaluations","pages":[{"title":"Resume Eval Route","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/eval/{run_id}/resume","href":"/api-reference/eval/resume-eval-route"},{"title":"Get evaluation options","deprecated":null,"version":null,"sidebarTitle":"Get eval options route","openapi":"/openapi.json get /api/v1/eval/options","href":"/api-reference/eval/get-eval-options-route"},{"title":"Get an evaluation run","deprecated":null,"version":null,"sidebarTitle":"Get eval run route","openapi":"/openapi.json get /api/v1/eval/{run_id}","href":"/api-reference/eval/get-eval-run-route"},{"title":"Delete an evaluation run","deprecated":null,"version":null,"sidebarTitle":"Delete eval run route","openapi":"/openapi.json delete /api/v1/eval/{run_id}","href":"/api-reference/eval/delete-eval-run-route"},{"title":"Start an evaluation","deprecated":null,"version":null,"sidebarTitle":"Start eval route","openapi":"/openapi.json post /api/v1/eval","href":"/api-reference/eval/start-eval-route"},{"title":"Cancel an evaluation","deprecated":null,"version":null,"sidebarTitle":"Cancel an evaluation","openapi":"/openapi.json post /api/v1/eval/{run_id}/cancel","href":"/api-reference/eval/cancel-an-evaluation"},{"title":"List evaluation runs","deprecated":null,"version":null,"sidebarTitle":"List eval runs route","openapi":"/openapi.json get /api/v1/eval/{bench_id}/runs","href":"/api-reference/eval/list-eval-runs-route"},{"title":"Get evaluation progress","deprecated":null,"version":null,"sidebarTitle":"Get eval progress route","openapi":"/openapi.json get /api/v1/eval/{run_id}/progress","href":"/api-reference/eval/get-eval-progress-route"},{"title":"Get Eval Remaining Work Route","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/eval/{eval_run_id}/remaining-work","href":"/api-reference/eval/get-eval-remaining-work-route"},{"title":"Get evaluation rewards","deprecated":null,"version":null,"sidebarTitle":"Get eval trajectory rewards route","openapi":"/openapi.json get /api/v1/eval/{run_id}/trajectory-rewards","href":"/api-reference/eval/get-eval-trajectory-rewards-route"},{"title":"Get evaluation rollout statistics","description":"Retrieve recorded distributions of trajectory settings and runtime measurements for an evaluation.","deprecated":null,"version":null,"sidebarTitle":"Get eval rollout statistics route","openapi":"/openapi.json get /api/v1/eval/{run_id}/rollout-statistics","href":"/api-reference/eval/get-eval-rollout-statistics-route"}]},{"group":"Telemetry","pages":[{"title":"Ingest telemetry events","deprecated":null,"version":null,"sidebarTitle":"Ingest events","openapi":"/openapi.json post /api/v1/telemetry/events","href":"/api-reference/telemetry/ingest-events"}]},{"group":"Training","pages":[{"title":"Add training samples","description":"Private beta: add completed, graded production trajectories to a streaming training run. Both production learning workflows, with or without an existing grader, require private-beta access. Traces need validated grading criteria before they can supply a learning signal.","deprecated":null,"version":null,"sidebarTitle":"Add training samples","openapi":"/openapi.json post /api/v1/train/{run_id}/samples","href":"/api-reference/training/add-training-samples"},{"title":"Start a training run","deprecated":null,"version":null,"sidebarTitle":"Create training run route","openapi":"/openapi.json post /api/v1/train","href":"/api-reference/training/create-training-run-route"},{"title":"Get training options","deprecated":null,"version":null,"sidebarTitle":"Get training options route","openapi":"/openapi.json get /api/v1/train/options","href":"/api-reference/training/get-training-options-route"},{"title":"List training runs","deprecated":null,"version":null,"sidebarTitle":"List training runs route","openapi":"/openapi.json get /api/v1/train/{bench_id}/runs","href":"/api-reference/training/list-training-runs-route"},{"title":"Get a training run","deprecated":null,"version":null,"sidebarTitle":"Get training run route","openapi":"/openapi.json get /api/v1/train/{run_id}","href":"/api-reference/training/get-training-run-route"},{"title":"Delete a training run","deprecated":null,"version":null,"sidebarTitle":"Delete training run route","openapi":"/openapi.json delete /api/v1/train/{run_id}","href":"/api-reference/training/delete-training-run-route"},{"title":"Update Training Run Route","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/train/{training_run_id}","href":"/api-reference/training/update-training-run-route"},{"title":"Get training progress","deprecated":null,"version":null,"sidebarTitle":"Get training progress route","openapi":"/openapi.json get /api/v1/train/{run_id}/progress","href":"/api-reference/training/get-training-progress-route"},{"title":"Get training rewards by step","deprecated":null,"version":null,"sidebarTitle":"Get trainer rewards by step","openapi":"/openapi.json get /api/v1/train/{run_id}/step/trainer-reward-by-step","href":"/api-reference/training/get-trainer-rewards-by-step"},{"title":"Get held-out rewards by step","deprecated":null,"version":null,"sidebarTitle":"Get held out rewards by step","openapi":"/openapi.json get /api/v1/train/{run_id}/step/held-out-reward-by-step","href":"/api-reference/training/get-held-out-rewards-by-step"},{"title":"Get training step summaries","deprecated":null,"version":null,"sidebarTitle":"Get training step summaries","openapi":"/openapi.json get /api/v1/train/{run_id}/step-summaries","href":"/api-reference/training/get-training-step-summaries"},{"title":"List training step trajectories","deprecated":null,"version":null,"sidebarTitle":"List training step trajectories","openapi":"/openapi.json get /api/v1/train/{run_id}/steps/{step}/trajectories","href":"/api-reference/training/list-training-step-trajectories"},{"title":"Get Training Step Group Stats Route","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/train/{run_id}/steps/{step}/group-stats","href":"/api-reference/training/get-training-step-group-stats-route"},{"title":"List Training Step Groups Route","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/train/{run_id}/steps/{step}/groups","href":"/api-reference/training/list-training-step-groups-route"},{"title":"Get training trajectory rewards","deprecated":null,"version":null,"sidebarTitle":"Get training trajectory rewards route","openapi":"/openapi.json get /api/v1/train/{run_id}/steps/{step}/trajectory-rewards","href":"/api-reference/training/get-training-trajectory-rewards-route"},{"title":"Cancel a training run","deprecated":null,"version":null,"sidebarTitle":"Cancel training run route","openapi":"/openapi.json post /api/v1/train/{run_id}/cancel","href":"/api-reference/training/cancel-training-run-route"},{"title":"List Training Checkpoints Route","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/train/{run_id}/checkpoints","href":"/api-reference/training/list-training-checkpoints-route"},{"title":"Get a training checkpoint","deprecated":null,"version":null,"sidebarTitle":"Get training checkpoint route","openapi":"/openapi.json get /api/v1/train/{run_id}/checkpoints/{step_index}","href":"/api-reference/training/get-training-checkpoint-route"}]}]}]}]},"basePath":"","title":"Ingest telemetry events - Trajectory","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}