Get a specific version of a ground truth.Parameters:
Name
Type
Description
Default
agent_id
int
The ID of the agent
required
ground_truth_id
int
The ID of the ground truth
required
version
int
The version number to retrieve
required
list_versions
list_versions( agent_id: int, ground_truth_id: int, page_number: int = 0, page_size: int = 50,) -> ListGroundTruthVersionsResponse
Get a paginated list of all versions of a ground truth.Parameters:
Name
Type
Description
Default
agent_id
int
The ID of the agent
required
ground_truth_id
int
The ID of the ground truth
required
page_number
int
Page number for pagination (default: 0)
0
page_size
int
Number of items per page (default: 50, max: 1000)
50
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Kolena","colors":{"primary":"#6434c1","light":"#6434c1","dark":"#6434c1"},"logo":{"light":"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/wordmark.png?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=75dc903296dd57fc21c61b4d6aadff38","dark":"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/wordmark.png?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=75dc903296dd57fc21c61b4d6aadff38"},"favicon":"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/favicon-96x96.webp?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=0acb5fa71c8c598c9cedbaafeaef2c0d","api":{"playground":{"display":"none"},"examples":{"defaults":"required"},"mdx":{"server":"https://agents-api.kolena.com"}},"appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"mailto:support@kolena.com","label":"Support"}],"primary":{"type":"button","label":"Kolena","href":"https://agents.kolena.com"}},"footer":{"socials":{"x":"https://x.com/kolenaIO","github":"https://github.com/kolenaIO","linkedin":"https://www.linkedin.com/company/kolena-ai"}},"fonts":{"heading":{"family":"Sora","weight":500},"body":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kolena","hasAudioNarration":false,"actualSubdomain":"kolena","customDomains":["docs.agents.kolena.com"],"gitSource":{"type":"github","owner":"kolenaio","repo":"restructured","deployBranch":"trunk","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afca899601d1e363acf9412","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Developers","count":51},{"language":"default","tag":"Users","count":34},{"language":"default","tag":"API","count":33},{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Python Client","count":18},{"language":"default","tag":"Get Started","count":14},{"language":"default","tag":"Managing Your Organization","count":12},{"language":"default","tag":"Agents","count":11},{"language":"default","tag":"Ground Truths","count":11},{"language":"default","tag":"Resources","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"python-client/reference/v0.20.0/ground-truth","slug":"/python-client/reference/v0.20.0/ground-truth","pageMetadata":{"title":"client.ground_truth","description":null,"href":"/python-client/reference/v0.20.0/ground-truth"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`create`,children:_jsx(_components.code,{children:`create`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`create(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` name: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` evaluation_instructions: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` runs: List[GroundTruthRun],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`->`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` GroundTruth`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Create a new ground truth for an agent.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the agent`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`str`})}),_jsx(_components.td,{children:`Name of the ground truth`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`evaluation_instructions`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`str`})}),_jsx(_components.td,{children:`Instructions used to evaluate agent runs against this ground truth`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`runs`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`List[GroundTruthRun]`})}),_jsx(_components.td,{children:`List of ground truth runs defining the expected data`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`get`,children:_jsx(_components.code,{children:`get`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`get(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, ground_truth_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`->`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` GroundTruth`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Get a specific ground truth by ID.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the agent`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ground_truth_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the ground truth to retrieve`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`list`,children:_jsx(_components.code,{children:`list`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`list`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, page_number: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`int`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, page_size: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`int`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 50`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`->`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ListGroundTruthsResponse`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Get a paginated list of ground truths for an agent.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the agent`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page_number`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`Page number for pagination (default: 0)`}),_jsx(_components.td,{children:_jsx(`code`,{children:`0`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page_size`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`Number of items per page (default: 50, max: 1000)`}),_jsx(_components.td,{children:_jsx(`code`,{children:`50`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`delete`,children:_jsx(_components.code,{children:`delete`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`delete(agent_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, ground_truth_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`->`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Delete a specific ground truth.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the agent`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ground_truth_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the ground truth to delete`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`create_version`,children:_jsx(_components.code,{children:`create_version`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`create_version(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ground_truth_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` evaluation_instructions: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` runs: List[GroundTruthRun],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`->`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` GroundTruth`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Create a new version of an existing ground truth.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the agent`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ground_truth_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the ground truth to version`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`evaluation_instructions`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`str`})}),_jsx(_components.td,{children:`Updated evaluation instructions for this version`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`runs`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`List[GroundTruthRun]`})}),_jsx(_components.td,{children:`Updated list of ground truth runs for this version`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`get_version`,children:_jsx(_components.code,{children:`get_version`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`get_version(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, ground_truth_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, version: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`->`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` GroundTruth`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Get a specific version of a ground truth.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the agent`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ground_truth_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the ground truth`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`version`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The version number to retrieve`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`list_versions`,children:_jsx(_components.code,{children:`list_versions`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`list_versions(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ground_truth_id: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page_number: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`int`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page_size: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`int`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 50`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`->`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ListGroundTruthVersionsResponse`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Get a paginated list of all versions of a ground truth.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the agent`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ground_truth_id`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`The ID of the ground truth`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page_number`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`Page number for pagination (default: 0)`}),_jsx(_components.td,{children:_jsx(`code`,{children:`0`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page_size`})}),_jsx(_components.td,{children:_jsx(`code`,{children:`int`})}),_jsx(_components.td,{children:`Number of items per page (default: 50, max: 1000)`}),_jsx(_components.td,{children:_jsx(`code`,{children:`50`})})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"client.ground_truth","description":null,"href":"/python-client/reference/v0.20.0/ground-truth"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"create","slug":"create","depth":2,"children":[]},{"title":"get","slug":"get","depth":2,"children":[]},{"title":"list","slug":"list","depth":2,"children":[]},{"title":"delete","slug":"delete","depth":2,"children":[]},{"title":"create_version","slug":"create_version","depth":2,"children":[]},{"title":"get_version","slug":"get_version","depth":2,"children":[]},{"title":"list_versions","slug":"list_versions","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"kolena","siteName":"Kolena","title":"client.ground_truth - Kolena","navMaps":{"firstHrefInVersion":{"v0.20.0":{"href":"/python-client/reference/v0.20.0/ground-truth","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T15:50:27.515Z","originalFileLocation":"python-client/reference/v0.20.0/ground-truth.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Kolena\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"client.ground_truth - Kolena\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kolena\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kolena.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=client.ground_truth\u0026amp;theme=09600c4c21fa73a31bb96a86\u0026amp;signature=8085278b7063afabcbb7c9bd470b2ee3ec3687bd66d6184fc0680cfa45ca3ac7\">\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=\"client.ground_truth - Kolena\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kolena.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=client.ground_truth\u0026amp;theme=09600c4c21fa73a31bb96a86\u0026amp;signature=8085278b7063afabcbb7c9bd470b2ee3ec3687bd66d6184fc0680cfa45ca3ac7\">\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/kolena/3gGeYDhdmk73d0dO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kolena\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6434c1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/python-client/reference/v0.20.0/ground-truth.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agents.kolena.com/#organization\",\"name\":\"Kolena\",\"url\":\"https://docs.agents.kolena.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/wordmark.png?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=75dc903296dd57fc21c61b4d6aadff38\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agents.kolena.com#website\",\"name\":\"Kolena\",\"url\":\"https://docs.agents.kolena.com\",\"publisher\":{\"@id\":\"https://docs.agents.kolena.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth#webpage\",\"url\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth\",\"name\":\"client.ground_truth\",\"dateModified\":\"2026-11-17T15:50:27.515Z\",\"isPartOf\":{\"@id\":\"https://docs.agents.kolena.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Resources\",\"item\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/access-logs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"client.ground_truth\",\"item\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth#article\",\"headline\":\"client.ground_truth\",\"name\":\"client.ground_truth\",\"url\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agents.kolena.com/python-client/reference/v0.20.0/ground-truth#webpage\"},\"dateModified\":\"2026-11-17T15:50:27.515Z\",\"publisher\":{\"@id\":\"https://docs.agents.kolena.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agents.kolena.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kolena\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Kolena\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/python-client/reference/v0.20.0/ground-truth.md","siteName":"Kolena","nav":{"global":null,"tabs":[{"tab":"Users","pages":[{"title":"Users","href":"/introduction"}]},{"tab":"Developers","dropdowns":[{"dropdown":"API","icon":"code","groups":[{"group":"Connecting to Kolena","pages":[{"title":"Overview","href":"/connecting-to-kolena"},{"title":"Manage API Keys","href":"/api-keys"}]},{"group":"API Reference","pages":[{"title":"Quickstart Guide","href":"/api-reference/quickstart"},{"group":"Agents","pages":[{"title":"List Agents","openapi":"openapi.json GET /api/v1/client/agents","href":"/api-reference/list-agents"},{"title":"Get Agent","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}","href":"/api-reference/get-agent"},{"title":"Copy Agent","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/copy","href":"/api-reference/copy-agent"},{"title":"Update Agent","openapi":"openapi.json PATCH /api/v1/client/agents/{agent_id}","href":"/api-reference/update-agent"},{"title":"Add Agent Run","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs","href":"/api-reference/add-agent-run"},{"title":"Add Agent Run (and Wait)","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs/wait","href":"/api-reference/add-agent-run-wait"},{"title":"List Agent Runs","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/runs","href":"/api-reference/list-agent-runs"},{"title":"Get Agent Run","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/runs/{run_id}","href":"/api-reference/get-agent-run"},{"title":"Download Agent Run Templated Output","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs/{run_id}/templated-output","href":"/api-reference/download-agent-run-templated-output"},{"title":"Download Agent Runs Templated Output","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs/templated-output","href":"/api-reference/download-agent-runs-templated-output"},{"title":"Delete Agent Run","openapi":"openapi.json DELETE /api/v1/client/agents/{agent_id}/runs/{run_id}","href":"/api-reference/delete-agent-run"}]},{"group":"Access Logs","pages":[{"title":"Query Access Logs","openapi":"PUT /api/v1/client/access-logs/query","href":"/api-reference/query-access-logs"}]},{"group":"Ground Truths","pages":[{"title":"Create Ground Truth","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/ground_truths","href":"/api-reference/ground-truths/create-ground-truth"},{"title":"List Ground Truths","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths","href":"/api-reference/ground-truths/list-ground-truth"},{"title":"Get Ground Truth","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}","href":"/api-reference/ground-truths/get-ground-truth"},{"title":"Delete Ground Truth","openapi":"openapi.json DELETE /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}","href":"/api-reference/ground-truths/delete-ground-truth"},{"title":"Create Ground Truth Version","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/versions","href":"/api-reference/ground-truths/create-ground-truth-version"},{"title":"List Ground Truth Versions","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/versions","href":"/api-reference/ground-truths/list-ground-truth-versions"},{"title":"Get Ground Truth Version","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/versions/{version}","href":"/api-reference/ground-truths/get-ground-truth-version"},{"title":"Create Validation","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations","href":"/api-reference/ground-truths/create-validation"},{"title":"List Validations","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations","href":"/api-reference/ground-truths/list-validations"},{"title":"Get Validation","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations/{validation_id}","href":"/api-reference/ground-truths/get-validation"},{"title":"Delete Validation","openapi":"openapi.json DELETE /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations/{validation_id}","href":"/api-reference/ground-truths/delete-validation"}]},{"group":"Usage","pages":[{"title":"List Usage Records","openapi":"openapi.json GET /api/v1/client/usage","href":"/api-reference/list-usage-records"}]},{"group":"Workspaces","pages":[{"title":"List Workspaces","openapi":"openapi.json GET /api/v1/client/workspaces","href":"/api-reference/list-workspaces"}]},{"group":"API Keys","pages":[{"title":"Create API Key","openapi":"openapi.json POST /api/v1/client/api-keys","href":"/api-reference/create-api-key"},{"title":"List API Keys","openapi":"openapi.json GET /api/v1/client/api-keys","href":"/api-reference/list-api-keys"},{"title":"Get API Key","openapi":"openapi.json GET /api/v1/client/api-keys/{key_id}","href":"/api-reference/get-api-key"},{"title":"Delete API Key","openapi":"openapi.json DELETE /api/v1/client/api-keys/{key_id}","href":"/api-reference/delete-api-key"}]}]},{"group":"Webhook","pages":[{"title":"Webhook Integration","href":"/webhook"}]}]},{"dropdown":"Python Client","icon":"python","versions":[{"version":"v0.20.0","tag":"Latest","groups":[{"group":"Get Started","pages":[{"title":"Quickstart Guide","href":"/python-client/quickstart"}]},{"group":"Reference","pages":[{"title":"kolena_agents","href":"/python-client/reference/v0.20.0/kolena-agents"},{"title":"kolena_agents.webhook","href":"/python-client/reference/v0.20.0/webhook"}]},{"group":"Resources","pages":[{"title":"client.access_logs","href":"/python-client/reference/v0.20.0/access-logs"},{"title":"client.agent","href":"/python-client/reference/v0.20.0/agent"},{"title":"client.agent_run","href":"/python-client/reference/v0.20.0/agent-run"},{"title":"client.api_key","description":null,"href":"/python-client/reference/v0.20.0/api-key"},{"title":"client.ground_truth","href":"/python-client/reference/v0.20.0/ground-truth"},{"title":"client.usage","description":null,"href":"/python-client/reference/v0.20.0/usage"},{"title":"client.validation","href":"/python-client/reference/v0.20.0/validation"},{"title":"client.workspace","href":"/python-client/reference/v0.20.0/workspace"}]},{"group":"Types","pages":[{"title":"kolena_agents.types.access_logs","href":"/python-client/reference/v0.20.0/types-access-logs"},{"title":"kolena_agents.types.agent","href":"/python-client/reference/v0.20.0/types-agent"},{"title":"kolena_agents.types.agent_run","href":"/python-client/reference/v0.20.0/types-agent-run"},{"title":"kolena_agents.types.api_key","href":"/python-client/reference/v0.20.0/types-api-key"},{"title":"kolena_agents.types.exceptions","href":"/python-client/reference/v0.20.0/types-exceptions"},{"title":"kolena_agents.types.ground_truth","href":"/python-client/reference/v0.20.0/types-ground-truth"},{"title":"kolena_agents.types.usage","href":"/python-client/reference/v0.20.0/types-usage"}]}]}]}]}]},"basePath":"","title":"client.ground_truth - Kolena","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}