User-defined key→value tags for the trace. Maximum 20 keys;
keys and values are strings up to 64 characters each.
Queryable via the tag_key / tag_value query parameters on
GET /v1/traces. Omit or send an empty object when unused.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TruLayer","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/omnimodallc/Rc1rbNUGtX5WgsQI/logo/light.svg?fit=max\u0026auto=format\u0026n=Rc1rbNUGtX5WgsQI\u0026q=85\u0026s=533179b80c872f3f958c07a10a75b7ad","dark":"https://mintcdn.com/omnimodallc/Rc1rbNUGtX5WgsQI/logo/dark.svg?fit=max\u0026auto=format\u0026n=Rc1rbNUGtX5WgsQI\u0026q=85\u0026s=35f9b77cef986807c7a3f678adcfdb5e"},"favicon":"https://mintcdn.com/omnimodallc/xJho_XGKhESQfqYR/favicon.svg?fit=max\u0026auto=format\u0026n=xJho_XGKhESQfqYR\u0026q=85\u0026s=73c2634e0d88e4b01d70635608f04159","navbar":{"links":[{"href":"mailto:support@trulayer.ai","label":"Support"}],"primary":{"type":"button","label":"Sign up","href":"https://app.trulayer.ai/sign-up"}},"footer":{"socials":{"x":"https://x.com/trulayer_ai","github":"https://github.com/trulayer","linkedin":"https://linkedin.com/company/trulayer"}},"seo":{"metatags":{"canonical":"https://docs.trulayer.ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"https://app.trulayer.ai"},{"anchor":"Status","icon":"signal","href":"https://status.trulayer.ai"},{"anchor":"GitHub","icon":"github","href":"https://github.com/trulayer"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"omnimodallc","hasAudioNarration":false,"actualSubdomain":"omnimodallc","customDomains":["docs.trulayer.ai"],"gitSource":{"type":"github","owner":"trulayer","repo":"docs","deployBranch":"main","isPrivate":false,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a5d9860526179ec9eda3322","collectionId":"4240f09b-0968-4af5-aa3a-375dde840b29","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a5d9860526179ec9eda3322"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a5d9860526179ec9eda3322:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":110},{"language":"default","tag":"Endpoints","count":109},{"language":"default","tag":"Guides","count":87},{"language":"default","tag":"Dashboard","count":16},{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"control","count":9},{"language":"default","tag":"Go SDK","count":8},{"language":"default","tag":"datasets","count":8},{"language":"default","tag":"Python SDK","count":7},{"language":"default","tag":"TypeScript SDK","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/ingest/ingest-a-single-trace","slug":"/api-reference/ingest/ingest-a-single-trace","pageMetadata":{"title":"Ingest a single trace","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/ingest","href":"/api-reference/ingest/ingest-a-single-trace","autogeneratedByOpenApi":true},"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 a single trace","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/ingest","href":"/api-reference/ingest/ingest-a-single-trace","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"ingestTrace","tags":["ingest"],"summary":"Ingest a single trace","requestBody":"84081e28-05ec-4581-ba02-355c34281bf0","responses":{"200":"c0e9da98-a1cc-4cca-a05d-c8c6e275bcc4","201":"df817be6-c53b-4c64-a948-dc71029aba52","400":"1447b49d-2c88-42ee-921d-c843ad195b00","401":"af039a48-3fb6-46a2-917b-b4f344c5858a","429":"35f4e685-066f-4a50-9460-3174448bdbed"},"method":"post","type":"path","servers":["1fdfbe09-f60b-4dc4-876c-fd3c921de961","da4a1cd5-feab-463f-b8fb-4dc46866de30"],"security":["1a2e7257-0f54-402e-987e-25adc8adddab"],"path":"/v1/ingest","baseUrlOptions":["https://api.trulayer.ai","http://localhost:8080"],"title":"Ingest a single trace","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"external_id":{"oneOf":[{"type":"string","uniqueKey":"external_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"external_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"external_id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"input":{"oneOf":[{"type":"string","uniqueKey":"input.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"input.oneOf.1","typeLabel":"null"}],"uniqueKey":"input","typeLabel":"string | null"},"output":{"oneOf":[{"type":"string","uniqueKey":"output.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"output.oneOf.1","typeLabel":"null"}],"uniqueKey":"output","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"model.oneOf.1","typeLabel":"null"}],"uniqueKey":"model","typeLabel":"string | null"},"latency_ms":{"oneOf":[{"type":"integer","uniqueKey":"latency_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"latency_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"latency_ms","typeLabel":"integer | null"},"cost":{"oneOf":[{"type":"number","uniqueKey":"cost.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"cost","typeLabel":"number | null"},"error":{"oneOf":[{"type":"string","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"},"tags":{"description":"User-defined key→value tags for the trace. Maximum 20 keys;\nkeys and values are strings up to 64 characters each.\nQueryable via the `tag_key` / `tag_value` query parameters on\n`GET /v1/traces`. Omit or send an empty object when unused.\n","type":"object","additionalProperties":{"type":"string","uniqueKey":"tags.additionalProperties","typeLabel":"string"},"uniqueKey":"tags","typeLabel":"object"},"metadata":{"type":"object","additionalProperties":true,"uniqueKey":"metadata","typeLabel":"object"},"spans":{"type":"array","items":{"type":"object","required":["name","type"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"spans.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["llm","tool","retrieval","other"],"isRequired":true,"uniqueKey":"spans.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"spans.items.[INDEX].id","typeLabel":"string"},"parent_span_id":{"oneOf":[{"type":"string","uniqueKey":"spans.items.[INDEX].parent_span_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"spans.items.[INDEX].parent_span_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].parent_span_id","typeLabel":"string | null"},"input":{"oneOf":[{"type":"string","uniqueKey":"spans.items.[INDEX].input.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"spans.items.[INDEX].input.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].input","typeLabel":"string | null"},"output":{"oneOf":[{"type":"string","uniqueKey":"spans.items.[INDEX].output.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"spans.items.[INDEX].output.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].output","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","uniqueKey":"spans.items.[INDEX].model.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"spans.items.[INDEX].model.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].model","typeLabel":"string | null"},"latency_ms":{"oneOf":[{"type":"integer","uniqueKey":"spans.items.[INDEX].latency_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"spans.items.[INDEX].latency_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].latency_ms","typeLabel":"integer | null"},"cost":{"oneOf":[{"type":"number","uniqueKey":"spans.items.[INDEX].cost.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"spans.items.[INDEX].cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].cost","typeLabel":"number | null"},"error":{"oneOf":[{"type":"string","uniqueKey":"spans.items.[INDEX].error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"spans.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].error","typeLabel":"string | null"},"prompt_tokens":{"oneOf":[{"type":"integer","uniqueKey":"spans.items.[INDEX].prompt_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"spans.items.[INDEX].prompt_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].prompt_tokens","typeLabel":"integer | null"},"completion_tokens":{"oneOf":[{"type":"integer","uniqueKey":"spans.items.[INDEX].completion_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"spans.items.[INDEX].completion_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].completion_tokens","typeLabel":"integer | null"},"metadata":{"type":"object","additionalProperties":true,"uniqueKey":"spans.items.[INDEX].metadata","typeLabel":"object"},"start_time":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"spans.items.[INDEX].start_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"spans.items.[INDEX].start_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].start_time","typeLabel":"string\u003cdate-time> | null"},"end_time":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"spans.items.[INDEX].end_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"spans.items.[INDEX].end_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"spans.items.[INDEX].end_time","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"spans.items.[INDEX]","typeLabel":"object"},"uniqueKey":"spans","typeLabel":"object[]"},"events":{"type":"array","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"events.items.[INDEX].message","typeLabel":"string"},"id":{"type":"string","uniqueKey":"events.items.[INDEX].id","typeLabel":"string"},"span_id":{"oneOf":[{"type":"string","uniqueKey":"events.items.[INDEX].span_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"events.items.[INDEX].span_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"events.items.[INDEX].span_id","typeLabel":"string | null"},"level":{"type":"string","enum":["info","warn","error"],"default":"info","uniqueKey":"events.items.[INDEX].level","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","additionalProperties":true,"uniqueKey":"events.items.[INDEX].metadata","typeLabel":"object"}},"uniqueKey":"events.items.[INDEX]","typeLabel":"object"},"uniqueKey":"events","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","external_id":"\u003cstring>","name":"\u003cstring>","input":"\u003cstring>","output":"\u003cstring>","model":"\u003cstring>","latency_ms":123,"cost":123,"error":"\u003cstring>","tags":{},"metadata":{},"spans":[{"name":"\u003cstring>","id":"\u003cstring>","parent_span_id":"\u003cstring>","input":"\u003cstring>","output":"\u003cstring>","model":"\u003cstring>","latency_ms":123,"cost":123,"error":"\u003cstring>","prompt_tokens":123,"completion_tokens":123,"metadata":{},"start_time":"2023-11-07T05:31:56Z","end_time":"2023-11-07T05:31:56Z"}],"events":[{"message":"\u003cstring>","id":"\u003cstring>","span_id":"\u003cstring>","level":"info","metadata":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c0e9da98-a1cc-4cca-a05d-c8c6e275bcc4":{"description":"Duplicate — already ingested (idempotent)","content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"string","example":"duplicate","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"duplicate"}}},"exampleType":"generated"}},"exampleType":"generated"},"df817be6-c53b-4c64-a948-dc71029aba52":{"description":"Trace ingested","content":{"application/json":{"schema":{"type":"object","required":["id","created_at"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"1447b49d-2c88-42ee-921d-c843ad195b00":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"af039a48-3fb6-46a2-917b-b4f344c5858a":{"description":"Missing or invalid credentials","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"35f4e685-066f-4a50-9460-3174448bdbed":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1a2e7257-0f54-402e-987e-25adc8adddab":{"BearerAuth":{"type":"http","scheme":"bearer","description":"SDK API key (`tl_...`) or Clerk session JWT","scopes":[]}}},"servers":{"1fdfbe09-f60b-4dc4-876c-fd3c921de961":{"url":"https://api.trulayer.ai","description":"Production"},"da4a1cd5-feab-463f-b8fb-4dc46866de30":{"url":"http://localhost:8080","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"SDK API key (`tl_...`) or Clerk session JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"SDK API key (`tl_...`) or Clerk session JWT","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"omnimodallc","siteName":"TruLayer","title":"Ingest a single trace - TruLayer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-20T03:39:20.694Z","originalFileLocation":"api-reference/ingest/ingest-a-single-trace.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=\"application-name\" content=\"TruLayer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ingest a single trace - TruLayer\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TruLayer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://omnimodallc.mintlify.app/_mintlify/api/og/v2?division=ingest\u0026amp;title=Ingest+a+single+trace\u0026amp;theme=f30cc050865b51b401e85f73\u0026amp;signature=fcda497bd16b178437b581a52b86f0ea5cf0d906e89d356a94a3258afa0297f0\">\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 a single trace - TruLayer\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://omnimodallc.mintlify.app/_mintlify/api/og/v2?division=ingest\u0026amp;title=Ingest+a+single+trace\u0026amp;theme=f30cc050865b51b401e85f73\u0026amp;signature=fcda497bd16b178437b581a52b86f0ea5cf0d906e89d356a94a3258afa0297f0\">\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=\"/mintlify-assets/_mintlify/favicons/omnimodallc/IO9_gQbDt9V1gpMF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TruLayer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ingest/ingest-a-single-trace.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trulayer.ai/#organization\",\"name\":\"TruLayer\",\"url\":\"https://docs.trulayer.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/omnimodallc/Rc1rbNUGtX5WgsQI/logo/light.svg?fit=max\u0026auto=format\u0026n=Rc1rbNUGtX5WgsQI\u0026q=85\u0026s=533179b80c872f3f958c07a10a75b7ad\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trulayer.ai#website\",\"name\":\"TruLayer\",\"url\":\"https://docs.trulayer.ai\",\"publisher\":{\"@id\":\"https://docs.trulayer.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace#webpage\",\"url\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace\",\"name\":\"Ingest a single trace\",\"dateModified\":\"2026-07-20T03:39:20.694Z\",\"isPartOf\":{\"@id\":\"https://docs.trulayer.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.trulayer.ai/api-reference/health/liveness-check\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ingest a single trace\",\"item\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace#apireference\",\"headline\":\"Ingest a single trace\",\"name\":\"Ingest a single trace\",\"url\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trulayer.ai/api-reference/ingest/ingest-a-single-trace#webpage\"},\"dateModified\":\"2026-07-20T03:39:20.694Z\",\"publisher\":{\"@id\":\"https://docs.trulayer.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trulayer.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TruLayer\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TruLayer","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"https://app.trulayer.ai"},{"anchor":"Status","icon":"signal","href":"https://status.trulayer.ai"},{"anchor":"GitHub","icon":"github","href":"https://github.com/trulayer"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"health","pages":[{"title":"Liveness check","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /health","href":"/api-reference/health/liveness-check"}]},{"group":"ingest","pages":[{"title":"Ingest a single trace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/ingest","href":"/api-reference/ingest/ingest-a-single-trace"},{"title":"Ingest a batch of traces (max 100)","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/ingest/batch","href":"/api-reference/ingest/ingest-a-batch-of-traces-max-100"}]},{"group":"otlp","pages":[{"title":"OTLP/HTTP ingest endpoint (OTel GenAI semconv v1.29.0)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/otlp/traces","href":"/api-reference/otlp/otlphttp-ingest-endpoint-otel-genai-semconv-v1290"},{"title":"Export traces in OTLP/HTTP JSON format","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/otlp/export","href":"/api-reference/otlp/export-traces-in-otlphttp-json-format"}]},{"group":"traces","pages":[{"title":"List traces with cursor-based pagination","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/traces","href":"/api-reference/traces/list-traces-with-cursor-based-pagination"},{"title":"Get trace detail with spans and events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/traces/{id}","href":"/api-reference/traces/get-trace-detail-with-spans-and-events"},{"title":"Get the remediation chain for a trace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/traces/{id}/remediations","href":"/api-reference/traces/get-the-remediation-chain-for-a-trace"},{"title":"Stream the spans of a single trace as CSV or JSONL (sync export)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/traces/export","href":"/api-reference/traces/stream-the-spans-of-a-single-trace-as-csv-or-jsonl-sync-export"},{"title":"Server-Sent Events stream of live trace events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/traces/live","href":"/api-reference/traces/server-sent-events-stream-of-live-trace-events"}]},{"group":"deprecations","pages":[{"title":"List currently deprecated v1 fields and endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/deprecations","href":"/api-reference/deprecations/list-currently-deprecated-v1-fields-and-endpoints"}]},{"group":"metrics","pages":[{"title":"Aggregate metrics (error rate, latency percentiles, cost)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/metrics","href":"/api-reference/metrics/aggregate-metrics-error-rate-latency-percentiles-cost"},{"title":"Customer-facing ingestion pipeline health (TRU-167)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/ingestion-health","href":"/api-reference/metrics/customer-facing-ingestion-pipeline-health-tru-167"}]},{"group":"audit","pages":[{"title":"Verify a daily audit-log head-hash anchor (TRU-163)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/audit/verify","href":"/api-reference/audit/verify-a-daily-audit-log-head-hash-anchor-tru-163"}]},{"group":"compliance","pages":[{"title":"Public sub-processor registry (TRU-52)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/subprocessors","href":"/api-reference/compliance/public-sub-processor-registry-tru-52"},{"title":"Subscribe an email to sub-processor change notifications (TRU-52)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/subprocessors/subscribe","href":"/api-reference/compliance/subscribe-an-email-to-sub-processor-change-notifications-tru-52"},{"title":"Unsubscribe an email from sub-processor change notifications (TRU-52)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/subprocessors/unsubscribe","href":"/api-reference/compliance/unsubscribe-an-email-from-sub-processor-change-notifications-tru-52"}]},{"group":"dsr","pages":[{"title":"List Data Subject Requests for the authenticated tenant (TRU-57)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/dsr","href":"/api-reference/dsr/list-data-subject-requests-for-the-authenticated-tenant-tru-57"},{"title":"Submit a Data Subject Request (TRU-57)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/dsr","href":"/api-reference/dsr/submit-a-data-subject-request-tru-57"},{"title":"Fetch a single DSR request (TRU-57)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/dsr/{id}","href":"/api-reference/dsr/fetch-a-single-dsr-request-tru-57"}]},{"group":"policies","pages":[{"title":"List Control Loop Policies (TRU-67 Phase 1)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/policies","href":"/api-reference/policies/list-control-loop-policies-tru-67-phase-1"},{"title":"Create a Control Loop Policy (TRU-67 Phase 1)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/policies","href":"/api-reference/policies/create-a-control-loop-policy-tru-67-phase-1"},{"title":"Fetch a single policy (TRU-67 Phase 1)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/policies/{id}","href":"/api-reference/policies/fetch-a-single-policy-tru-67-phase-1"},{"title":"Archive a policy (TRU-67 Phase 1)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/policies/{id}","href":"/api-reference/policies/archive-a-policy-tru-67-phase-1"},{"title":"Update a policy (TRU-67 Phase 1)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/policies/{id}","href":"/api-reference/policies/update-a-policy-tru-67-phase-1"}]},{"group":"saved-filters","pages":[{"title":"List team-shared saved filters (TRU-216)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/saved-filters","href":"/api-reference/saved-filters/list-team-shared-saved-filters-tru-216"},{"title":"Create a saved filter (TRU-216)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/saved-filters","href":"/api-reference/saved-filters/create-a-saved-filter-tru-216"},{"title":"Delete a saved filter (TRU-216)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/saved-filters/{id}","href":"/api-reference/saved-filters/delete-a-saved-filter-tru-216"},{"title":"Update a saved filter (TRU-216)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/saved-filters/{id}","href":"/api-reference/saved-filters/update-a-saved-filter-tru-216"}]},{"group":"feedback","pages":[{"title":"List feedback for the tenant with cursor-based pagination","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/feedback","href":"/api-reference/feedback/list-feedback-for-the-tenant-with-cursor-based-pagination"},{"title":"Submit user feedback on a trace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/feedback","href":"/api-reference/feedback/submit-user-feedback-on-a-trace"}]},{"group":"failures","pages":[{"title":"Group error traces by message prefix and return failure clusters","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/failures/clusters","href":"/api-reference/failures/group-error-traces-by-message-prefix-and-return-failure-clusters"}]},{"group":"evals","pages":[{"title":"List evaluations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval","href":"/api-reference/evals/list-evaluations"},{"title":"Trigger an evaluation run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/eval","href":"/api-reference/evals/trigger-an-evaluation-run"},{"title":"Get evaluation result","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval/{id}","href":"/api-reference/evals/get-evaluation-result"},{"title":"Stream evaluations as CSV or JSONL (sync export)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval/export","href":"/api-reference/evals/stream-evaluations-as-csv-or-jsonl-sync-export"},{"title":"Get time-bucketed eval score averages per metric","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval/trends","href":"/api-reference/evals/get-time-bucketed-eval-score-averages-per-metric"},{"title":"Get score distribution histogram for a metric","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval/histogram","href":"/api-reference/evals/get-score-distribution-histogram-for-a-metric"},{"title":"Compare eval metrics between two time windows","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval/compare","href":"/api-reference/evals/compare-eval-metrics-between-two-time-windows"}]},{"group":"eval","pages":[{"title":"List pre-built LLM evaluators available for use","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval-catalog","href":"/api-reference/eval/list-pre-built-llm-evaluators-available-for-use"}]},{"group":"eval-rules","pages":[{"title":"List eval rules for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval-rules","href":"/api-reference/eval-rules/list-eval-rules-for-the-tenant"},{"title":"Create an eval rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/eval-rules","href":"/api-reference/eval-rules/create-an-eval-rule"},{"title":"Delete an eval rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/eval-rules/{id}","href":"/api-reference/eval-rules/delete-an-eval-rule"},{"title":"Update an eval rule (partial update)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/eval-rules/{id}","href":"/api-reference/eval-rules/update-an-eval-rule-partial-update"}]},{"group":"failure-rules","pages":[{"title":"List failure detection rules for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/failure-rules","href":"/api-reference/failure-rules/list-failure-detection-rules-for-the-tenant"},{"title":"Create a failure detection rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/failure-rules","href":"/api-reference/failure-rules/create-a-failure-detection-rule"},{"title":"Get a single failure detection rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/failure-rules/{id}","href":"/api-reference/failure-rules/get-a-single-failure-detection-rule"},{"title":"Delete a failure detection rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/failure-rules/{id}","href":"/api-reference/failure-rules/delete-a-failure-detection-rule"},{"title":"Update a failure detection rule (partial update)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/failure-rules/{id}","href":"/api-reference/failure-rules/update-a-failure-detection-rule-partial-update"}]},{"group":"control","pages":[{"title":"Execute a control action (retry, fallback model, or prompt modification)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/control/execute","href":"/api-reference/control/execute-a-control-action-retry-fallback-model-or-prompt-modification"},{"title":"List control actions for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/control/actions","href":"/api-reference/control/list-control-actions-for-the-tenant"},{"title":"Get the per-trace remediation diff for a control action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/control/actions/{id}/diff","href":"/api-reference/control/get-the-per-trace-remediation-diff-for-a-control-action"},{"title":"List control actions parked for human approval (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/control/actions/pending","href":"/api-reference/control/list-control-actions-parked-for-human-approval-owner-only"},{"title":"Approve a pending_approval control action (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/control/actions/{id}/approve","href":"/api-reference/control/approve-a-pending_approval-control-action-owner-only"},{"title":"Reject a pending_approval control action (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/control/actions/{id}/reject","href":"/api-reference/control/reject-a-pending_approval-control-action-owner-only"},{"title":"Get the tenant's control-loop kill-switch state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/control/killswitch","href":"/api-reference/control/get-the-tenants-control-loop-kill-switch-state"},{"title":"Enable the control-loop kill-switch (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/control/killswitch/enable","href":"/api-reference/control/enable-the-control-loop-kill-switch-owner-only"},{"title":"Disable the control-loop kill-switch (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/control/killswitch/disable","href":"/api-reference/control/disable-the-control-loop-kill-switch-owner-only"}]},{"group":"prompts","pages":[{"title":"List closed-loop prompt-improvement deployments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/prompts/deployments","href":"/api-reference/prompts/list-closed-loop-prompt-improvement-deployments"},{"title":"Get a single prompt deployment by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/prompts/deployments/{id}","href":"/api-reference/prompts/get-a-single-prompt-deployment-by-id"},{"title":"Approve a prompt deployment for ship (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/prompts/deployments/{id}/approve","href":"/api-reference/prompts/approve-a-prompt-deployment-for-ship-owner-only"},{"title":"Reject a non-terminal prompt deployment (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/prompts/deployments/{id}/reject","href":"/api-reference/prompts/reject-a-non-terminal-prompt-deployment-owner-only"},{"title":"Roll a shipped or monitoring/regressed prompt deployment back (owner-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/prompts/deployments/{id}/rollback","href":"/api-reference/prompts/roll-a-shipped-or-monitoringregressed-prompt-deployment-back-owner-only"}]},{"group":"apikeys","pages":[{"title":"List API keys for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/apikeys","href":"/api-reference/apikeys/list-api-keys-for-the-tenant"},{"title":"Create an API key (owner or member; requires Clerk auth)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/apikeys","href":"/api-reference/apikeys/create-an-api-key-owner-or-member;-requires-clerk-auth"},{"title":"Revoke an API key (owner only; requires Clerk auth)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/apikeys/{id}","href":"/api-reference/apikeys/revoke-an-api-key-owner-only;-requires-clerk-auth"},{"title":"Rotate an API key (owner or member; requires Clerk auth)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/apikeys/{id}/rotate","href":"/api-reference/apikeys/rotate-an-api-key-owner-or-member;-requires-clerk-auth"}]},{"group":"projects","pages":[{"title":"List projects for the authenticated tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/projects","href":"/api-reference/projects/list-projects-for-the-authenticated-tenant"},{"title":"Create a new project (owner or member; requires Clerk auth)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/projects","href":"/api-reference/projects/create-a-new-project-owner-or-member;-requires-clerk-auth"},{"title":"Update a project (rename or adjust retention override)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/projects/{id}","href":"/api-reference/projects/update-a-project-rename-or-adjust-retention-override"},{"title":"Archive a project (owner only; requires Clerk auth)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/projects/{id}/archive","href":"/api-reference/projects/archive-a-project-owner-only;-requires-clerk-auth"},{"title":"Unarchive a previously-archived project (owner only; requires Clerk auth)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/projects/{id}/unarchive","href":"/api-reference/projects/unarchive-a-previously-archived-project-owner-only;-requires-clerk-auth"},{"title":"Read a single project-scoped metric (TRU-362)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/projects/{id}/metrics","href":"/api-reference/projects/read-a-single-project-scoped-metric-tru-362"}]},{"group":"datasets","pages":[{"title":"List datasets for the authenticated tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets","href":"/api-reference/datasets/list-datasets-for-the-authenticated-tenant"},{"title":"Create a new dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets","href":"/api-reference/datasets/create-a-new-dataset"},{"title":"Get a single dataset by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}","href":"/api-reference/datasets/get-a-single-dataset-by-id"},{"title":"Delete a dataset and its items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/datasets/{id}","href":"/api-reference/datasets/delete-a-dataset-and-its-items"},{"title":"List items for a dataset with cursor-based pagination","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}/items","href":"/api-reference/datasets/list-items-for-a-dataset-with-cursor-based-pagination"},{"title":"Add an item to a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets/{id}/items","href":"/api-reference/datasets/add-an-item-to-a-dataset"},{"title":"Stream dataset items as CSV or JSONL (sync export)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}/export","href":"/api-reference/datasets/stream-dataset-items-as-csv-or-jsonl-sync-export"},{"title":"Update a dataset item's label","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/datasets/{id}/items/{itemId}","href":"/api-reference/datasets/update-a-dataset-items-label"}]},{"group":"model-routes","pages":[{"title":"List model routes for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/model-routes","href":"/api-reference/model-routes/list-model-routes-for-the-tenant"},{"title":"Create a model route","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/model-routes","href":"/api-reference/model-routes/create-a-model-route"},{"title":"Delete a model route","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/model-routes/{id}","href":"/api-reference/model-routes/delete-a-model-route"},{"title":"Update a model route (partial update)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/model-routes/{id}","href":"/api-reference/model-routes/update-a-model-route-partial-update"}]},{"group":"search","pages":[{"title":"Free-text semantic search over span embeddings (server-side embed)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/search/spans","href":"/api-reference/search/free-text-semantic-search-over-span-embeddings-server-side-embed"},{"title":"Find spans semantically similar to a query vector","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/search/spans","href":"/api-reference/search/find-spans-semantically-similar-to-a-query-vector"}]},{"group":"webhooks","pages":[{"title":"List webhooks for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/webhooks","href":"/api-reference/webhooks/list-webhooks-for-the-tenant"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Delete a webhook (owner only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook-owner-only"},{"title":"Send a synthetic ping event to verify a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/webhooks/{id}/test","href":"/api-reference/webhooks/send-a-synthetic-ping-event-to-verify-a-webhook-endpoint"}]},{"group":"anomaly","pages":[{"title":"List detected anomalies for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/anomalies","href":"/api-reference/anomaly/list-detected-anomalies-for-the-tenant"},{"title":"Get a single anomaly by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/anomalies/{id}","href":"/api-reference/anomaly/get-a-single-anomaly-by-id"}]},{"group":"eval-runs","pages":[{"title":"List eval versions for a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}/versions","href":"/api-reference/eval-runs/list-eval-versions-for-a-dataset"},{"title":"Create an eval version for a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets/{id}/versions","href":"/api-reference/eval-runs/create-an-eval-version-for-a-dataset"},{"title":"List eval runs for a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}/runs","href":"/api-reference/eval-runs/list-eval-runs-for-a-dataset"},{"title":"Schedule an eval run against a dataset version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets/{id}/runs","href":"/api-reference/eval-runs/schedule-an-eval-run-against-a-dataset-version"},{"title":"Get eval run status and progress","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval-runs/{id}","href":"/api-reference/eval-runs/get-eval-run-status-and-progress"},{"title":"Export eval run results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval-runs/{id}/export","href":"/api-reference/eval-runs/export-eval-run-results"},{"title":"Score diff between two eval runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/eval-runs/{id}/diff","href":"/api-reference/eval-runs/score-diff-between-two-eval-runs"}]},{"group":"eval-keys","pages":[{"title":"List active BYOK keys for premium eval models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/settings/eval-keys","href":"/api-reference/eval-keys/list-active-byok-keys-for-premium-eval-models"},{"title":"Create or replace the BYOK key for a provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/settings/eval-keys","href":"/api-reference/eval-keys/create-or-replace-the-byok-key-for-a-provider"},{"title":"Revoke the BYOK key for a provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/settings/eval-keys/{provider}","href":"/api-reference/eval-keys/revoke-the-byok-key-for-a-provider"}]},{"group":"billing","pages":[{"title":"Create a Stripe Checkout session for a plan upgrade","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/settings/billing/checkout","href":"/api-reference/billing/create-a-stripe-checkout-session-for-a-plan-upgrade"},{"title":"Create a Stripe Billing Portal session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/settings/billing/portal","href":"/api-reference/billing/create-a-stripe-billing-portal-session"},{"title":"List recent Stripe invoices for the tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/settings/invoices","href":"/api-reference/billing/list-recent-stripe-invoices-for-the-tenant"}]},{"group":"ci","pages":[{"title":"Evaluate an eval run against a CI policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/ci/gate","href":"/api-reference/ci/evaluate-an-eval-run-against-a-ci-policy"}]},{"group":"members","pages":[{"title":"Count active API keys created by a member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/members/{id}/key-count","href":"/api-reference/members/count-active-api-keys-created-by-a-member"},{"title":"Remove the authenticated user from the current organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/members/me","href":"/api-reference/members/remove-the-authenticated-user-from-the-current-organization"}]}]}]}]},"title":"Ingest a single trace - TruLayer","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}