{
"error": {
"code": "NOT_FOUND",
"message": "Tag not found",
"details": [
{
"field": "tag_id",
"description": "Tag not found or not accessible by your organization"
}
]
}
}
{
"error": {
"code": "NOT_FOUND",
"message": "Tag not found",
"details": [
{
"field": "tag_id",
"description": "Tag not found or not accessible by your organization"
}
]
}
}
Tag resource. Tags are used to organize agents, personas, test sets, metrics, and run templates.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Coval Documentation","colors":{"primary":"#000000","light":"#D9D9D9","dark":"#333333"},"logo":{"light":"https://mintcdn.com/coval-2e18a559/Notp6opJUCHArykW/logo/coval-logo-vector.svg?fit=max\u0026auto=format\u0026n=Notp6opJUCHArykW\u0026q=85\u0026s=f08474458e9c5bbff1e1d7119fdc8012","dark":"https://mintcdn.com/coval-2e18a559/Notp6opJUCHArykW/logo/coval-logo-vector-white.svg?fit=max\u0026auto=format\u0026n=Notp6opJUCHArykW\u0026q=85\u0026s=ed477a66f2ca12c3c7a0289aa7c5bfb4"},"favicon":"https://mintcdn.com/coval-2e18a559/h96r_q_HmNOhXnSr/favicon.png?fit=max\u0026auto=format\u0026n=h96r_q_HmNOhXnSr\u0026q=85\u0026s=3451522324a1d00b3ad7c50ef0b825b3","api":{"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.coval.dev"}},"appearance":{"default":"light"},"background":{"image":"https://mintlify.s3.us-west-1.amazonaws.com/coval-2e18a559/images/background/frame_16opblack.svg","color":{"light":"#F2F1EE","dark":"#000000"}},"navbar":{"links":[{"href":"/changelog","label":"Changelog"},{"href":"mailto:support@coval.dev","label":"Support"},{"href":"https://www.coval.dev","label":"Website"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.coval.dev"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/covaldev","twitter":"https://x.com/covaldev"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"coval-2e18a559","hasAudioNarration":false,"actualSubdomain":"coval-2e18a559","customDomains":["docs.coval.ai"],"gitSource":{"type":"github","owner":"coval-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aef92d05a64506a906a5a99","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API","count":193},{"language":"default","tag":"Home","count":76},{"language":"default","tag":"Resources","count":44},{"language":"default","tag":"Simulated Conversations","count":41},{"language":"default","tag":"Metrics","count":34},{"language":"default","tag":"Agents","count":29},{"language":"default","tag":"CLI","count":22},{"language":"default","tag":"Test Sets","count":17},{"language":"default","tag":"Reviews","count":17},{"language":"default","tag":"Uploaded Conversations","count":16}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".cl{position:relative;max-width:880px}.cl-entry{position:relative;display:grid;grid-template-columns:96px 1fr;column-gap:2.5rem;padding-bottom:2.5rem}.cl-entry::before{content:\"\";position:absolute;left:96px;top:8px;bottom:-8px;width:2px;background:#dcdad5}.cl-entry:last-child::before{display:none}.cl-entry::after{content:\"\";position:absolute;left:91px;top:7px;width:12px;height:12px;border-radius:50%;background:#11161f;box-shadow:0 0 0 4px #f2f1ee}.cl-rail{text-align:center}.cl-rail__date{font-size:1.4rem;font-weight:700;color:#1a1a1a;line-height:1.1}.cl-rail__year{font-size:1.05rem;color:#9a958c;font-weight:500}.cl-rail__count{margin-top:0.35rem;font-size:0.8rem;color:#a8a399}.cl-content{min-width:0}.cl-highlights{background:#0f1320;border-radius:16px;padding:1.4rem 1.75rem;margin-bottom:1.25rem}.cl-highlights__label{font-size:0.72rem;letter-spacing:0.12em;text-transform:uppercase;font-weight:600;color:#8b94a5}.cl-highlights__list{margin:0.65rem 0 0;padding:0;list-style:none}.cl-highlights__list li{position:relative;padding-left:1.1rem;margin:0.3rem 0;font-size:1rem;line-height:1.45;color:#f5f6f8}.cl-highlights__list li::before{content:\"\";position:absolute;left:0;top:0.6em;width:5px;height:5px;border-radius:50%;background:#8b94a5}.cl-card{position:relative;background:#fff;border:1px solid #ececec;border-radius:16px;padding:1.5rem 1.75rem;margin-bottom:1rem}.cl-card__title{font-size:1.25rem;font-weight:700;color:#1a1a1a;margin-bottom:0.5rem}.cl-card__desc{color:#5b5b5b;line-height:1.55;margin:0}.cl-card__extra{display:none}.cl-card__divider{border:none;border-top:1px solid #ededed;margin:1.1rem 0}.cl-card__extra p{color:#5b5b5b;line-height:1.55}.cl-card__extra a,.cl-doc-link{color:#15803d;font-weight:600;text-decoration:none}.cl-card__extra a:hover{text-decoration:none;opacity:0.8}.cl-card__footer{display:flex;align-items:center;gap:0.75rem;margin-top:1.1rem}.cl-pill{font-size:0.8rem;font-weight:600;padding:0.25rem 0.7rem;border-radius:999px}.cl-pill--new{background:#d9f0e1;color:#1a7f4b}.cl-pill--improved{background:#dde9fb;color:#1d4ed8}.cl-pill--fixed{background:#fdeccf;color:#b45309}.cl-cat{font-size:0.85rem;color:#9aa0a6}.cl-cb{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0}.cl-toggle{margin-left:auto;cursor:pointer;user-select:none;font-size:0.85rem;font-weight:500;color:#1f2433;border:1px solid #cdd5e3;border-radius:9px;padding:0.45rem 0.85rem;white-space:nowrap}.cl-toggle:hover{background:#f6f8fc}.cl-cb:focus-visible~.cl-card__footer .cl-toggle{outline:2px solid #4f6bed;outline-offset:2px}.cl-toggle .less{display:none}.cl-cb:checked~.cl-card__extra{display:block}.cl-cb:checked~.cl-card__footer .cl-toggle .more{display:none}.cl-cb:checked~.cl-card__footer .cl-toggle .less{display:inline}.dark .cl-entry::before{background:#2a2f3a}.dark .cl-entry::after{background:#e5e7eb;box-shadow:0 0 0 4px #000}.dark .cl-rail__date{color:#f5f6f8}.dark .cl-rail__year{color:#9aa0ad}.dark .cl-rail__count{color:#7e8493}.dark .cl-card{background:#11161f;border-color:#242a36}.dark .cl-card__title{color:#f5f6f8}.dark .cl-card__desc,.dark .cl-card__extra p{color:#aab1bd}.dark .cl-card__divider{border-top-color:#262b36}.dark .cl-card__extra a,.dark .cl-doc-link{color:#4ade80}.dark .cl-pill--new{background:#10301d;color:#5cd98c}.dark .cl-pill--improved{background:#13233f;color:#7aa6f5}.dark .cl-pill--fixed{background:#3a2a10;color:#e0a955}.dark .cl-cat{color:#8b909a}.dark .cl-toggle{color:#cbd2de;border-color:#333a47}.dark .cl-toggle:hover{background:#1a2030}@media (max-width: 640px){.cl-entry{grid-template-columns:1fr;row-gap:1rem}.cl-entry::before,.cl-entry::after{display:none}.cl-rail{display:flex;align-items:baseline;gap:0.5rem;text-align:left}}html:not(.dark) #search-bar-entry,html:not(.dark) #search-bar-entry *,html:not(.dark) #assistant-entry,html:not(.dark) #assistant-entry *{color:#5c5c5c}html:not(.dark) #footer a[href*=\"mintlify\"]{color:#5c5c5c}.dark #footer a[href*=\"mintlify\"]{color:#8c8c8c}html:not(.dark) .chat-assistant-disclaimer-text{color:#5c5c5c}.dark .chat-assistant-disclaimer-text{color:#a3a3a3}html:not(.dark) .method-nav-pill>.text-green-700{color:#166534}html:not(.dark) .method-nav-pill>.text-blue-700{color:#1e40af}html:not(.dark) .method-nav-pill>.text-orange-700{color:#9a3412}html:not(.dark) .method-nav-pill>.text-red-700{color:#991b1b}html:not(.dark) [class*=\"bg-[#FDEAD8]\"]{color:#8a4508}.dark [class*=\"bg-[#FDEAD8]\"]{color:#f5a35c}html:not(.dark) [data-component-part=\"field-required-pill\"]{color:#b91c1c}#chat-assistant-sheet[aria-hidden=\"true\"]>*,#chat-assistant-sheet[role=\"dialog\"]:not([data-open])>*{visibility:hidden}:focus-visible,#root :focus-visible{outline:2px solid #11161f!important;outline-offset:2px!important}.dark :focus-visible,.dark #root :focus-visible{outline-color:#f5f6f8!important}#root [data-radix-scroll-area-viewport]:focus-visible,#root pre:focus-visible,#root div[tabindex=\"0\"]:focus-visible{outline-offset:-2px!important}:has(>.chat-assistant-input:focus-visible){outline:2px solid #11161f;outline-offset:2px}.dark :has(>.chat-assistant-input:focus-visible){outline-color:#f5f6f8}"}],"page":{"pagePath":"api-reference/tags/get-tag","slug":"/api-reference/tags/get-tag","pageMetadata":{"title":"Get tag","description":"Retrieve a specific tag by its unique identifier.","deprecated":null,"version":null,"openapi":"/api-reference/v1/tags-v1.yaml get /tags/{tag_id}","href":"/api-reference/tags/get-tag","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a specific tag by its unique identifier.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get tag","description":"Retrieve a specific tag by its unique identifier.","deprecated":null,"version":null,"openapi":"/api-reference/v1/tags-v1.yaml get /tags/{tag_id}","href":"/api-reference/tags/get-tag","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/coval-2e18a559/96d9833460dc4be2/analytics.js","/_mintlify/custom/coval-2e18a559/37be8295f8507cc8/a11y.js"],"openApiReferenceData":{"operation":{"operationId":"getTag","summary":"Get tag","description":"Retrieve a specific tag by its unique identifier.","tags":["Tags"],"security":["3b831a39-e717-428e-81e8-008c413b83d9"],"parameters":["d64836d1-e9e8-4907-8420-7b5922b488b8"],"responses":{"200":"bca2b5e3-bb89-44d4-a8f3-eb55b2ed4216","401":"523c2fd3-bd52-4de7-a275-df8104aade9d","404":"f6e4b2bf-2ade-4d39-95ae-6aa1d637c582","500":"419f16bc-dad5-44a2-891c-c1308f430929"},"method":"get","type":"path","servers":["02caac78-6882-428d-8ad3-7d5559dac04d"],"path":"/tags/{tag_id}","baseUrlOptions":["https://api.coval.dev/v1"],"title":"Get tag","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d64836d1-e9e8-4907-8420-7b5922b488b8":{"name":"tag_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Tag resource ID","uniqueKey":"","typeLabel":"string"},"description":"Tag resource ID","example":"01HX2ABC3DEF4GHI5JKL6MNO7P"},"910cae46-bf8b-4a6d-ac57-82629d449f88":{"name":"X-Coval-Workspace-Id","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":26,"isRequired":false,"description":"Workspace that scopes this operation. When omitted, the organization's active default workspace is used when one can be resolved.","uniqueKey":"","typeLabel":"string"},"description":"Workspace that scopes this operation. When omitted, the organization's active default workspace is used when one can be resolved."}},"responses":{"bca2b5e3-bb89-44d4-a8f3-eb55b2ed4216":{"description":"Tag retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["tag"],"properties":{"tag":{"type":"object","description":"Tag resource. Tags are used to organize agents, personas, test sets, metrics, and run templates.","properties":{"name":{"type":"string","description":"Resource name in format \"tags/{tag_id}\"","example":"tags/01HX2ABC3DEF4GHI5JKL6MNO7P","isRequired":true,"uniqueKey":"tag.name","typeLabel":"string"},"id":{"type":"string","description":"Tag resource ID","example":"01HX2ABC3DEF4GHI5JKL6MNO7P","isRequired":true,"uniqueKey":"tag.id","typeLabel":"string"},"tag_name":{"type":"string","description":"Lowercase tag display name","example":"production","isRequired":true,"uniqueKey":"tag.tag_name","typeLabel":"string"},"create_time":{"type":"string","format":"date-time","description":"Creation timestamp (ISO 8601)","example":"2025-10-14T12:00:00Z","isRequired":true,"uniqueKey":"tag.create_time","typeLabel":"string\u003cdate-time>"},"color":{"oneOf":[{"type":"string","description":"Hex color code (#RGB,","example":"#3b82f6","uniqueKey":"tag.color.oneOf.0","typeLabel":"string"},{"type":"null","description":"Hex color code (#RGB,","example":"#3b82f6","uniqueKey":"tag.color.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag.color","typeLabel":"string | null"},"assignment_count":{"oneOf":[{"type":"integer","minimum":0,"description":"All resource assignments, including inactive resources, when include_usage is true.","uniqueKey":"tag.assignment_count.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"All resource assignments, including inactive resources, when include_usage is true.","uniqueKey":"tag.assignment_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag.assignment_count","typeLabel":"integer | null"},"usage":{"oneOf":[{"type":"object","description":"Live assignment counts when include_usage is true; otherwise null.","properties":{"runs":{"type":"integer","default":0,"uniqueKey":"tag.usage.oneOf.0.runs","typeLabel":"integer"},"agents":{"type":"integer","default":0,"uniqueKey":"tag.usage.oneOf.0.agents","typeLabel":"integer"},"test_sets":{"type":"integer","default":0,"uniqueKey":"tag.usage.oneOf.0.test_sets","typeLabel":"integer"},"personas":{"type":"integer","default":0,"uniqueKey":"tag.usage.oneOf.0.personas","typeLabel":"integer"},"metrics":{"type":"integer","default":0,"uniqueKey":"tag.usage.oneOf.0.metrics","typeLabel":"integer"},"run_templates":{"type":"integer","default":0,"uniqueKey":"tag.usage.oneOf.0.run_templates","typeLabel":"integer"}},"uniqueKey":"tag.usage.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"tag.usage.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag.usage","typeLabel":"object | null"},"created_by":{"oneOf":[{"type":"string","description":"Email of the user who created the tag","example":"engineer@example.com","uniqueKey":"tag.created_by.oneOf.0","typeLabel":"string"},{"type":"null","description":"Email of the user who created the tag","example":"engineer@example.com","uniqueKey":"tag.created_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag.created_by","typeLabel":"string | null"}},"required":["create_time","id","tag_name","name"],"isRequired":true,"uniqueKey":"tag","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","value":{"tag":{"name":"tags/01HX2ABC3DEF4GHI5JKL6MNO7P","id":"01HX2ABC3DEF4GHI5JKL6MNO7P","tag_name":"production","color":"#3b82f6","create_time":"2025-10-14T12:00:00Z","created_by":"engineer@example.com"}}}},"exampleType":"examples"}},"exampleType":"examples"},"523c2fd3-bd52-4de7-a275-df8104aade9d":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","required":["error"],"properties":{"error":{"type":"object","required":["code","message","details"],"properties":{"code":{"type":"string","description":"Error code enum","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","PERMISSION_DENIED","NOT_FOUND","ALREADY_EXISTS","INTERNAL"],"example":"INVALID_ARGUMENT","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request parameter","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Detailed error information","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","description":"Field name that caused the error","example":"tag_name","uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","description":"Field name that caused the error","example":"tag_name","uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"description":{"type":"string","description":"Detailed error description","example":"tag_name cannot be empty","uniqueKey":"error.details.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"UNAUTHENTICATED","message":"Authentication failed","details":[{"field":"X-API-Key","description":"Invalid or missing API key"}]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHENTICATED","message":"Authentication failed","details":[{"field":"X-API-Key","description":"Invalid or missing API key"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"f6e4b2bf-2ade-4d39-95ae-6aa1d637c582":{"description":"Tag not found or belongs to different organization","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","required":["error"],"properties":{"error":{"type":"object","required":["code","message","details"],"properties":{"code":{"type":"string","description":"Error code enum","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","PERMISSION_DENIED","NOT_FOUND","ALREADY_EXISTS","INTERNAL"],"example":"INVALID_ARGUMENT","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request parameter","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Detailed error information","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","description":"Field name that caused the error","example":"tag_name","uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","description":"Field name that caused the error","example":"tag_name","uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"description":{"type":"string","description":"Detailed error description","example":"tag_name cannot be empty","uniqueKey":"error.details.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"notFound":{"title":"notFound","value":{"error":{"code":"NOT_FOUND","message":"Tag not found","details":[{"field":"tag_id","description":"Tag not found or not accessible by your organization"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"419f16bc-dad5-44a2-891c-c1308f430929":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","required":["error"],"properties":{"error":{"type":"object","required":["code","message","details"],"properties":{"code":{"type":"string","description":"Error code enum","enum":["INVALID_ARGUMENT","UNAUTHENTICATED","PERMISSION_DENIED","NOT_FOUND","ALREADY_EXISTS","INTERNAL"],"example":"INVALID_ARGUMENT","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request parameter","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Detailed error information","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","description":"Field name that caused the error","example":"tag_name","uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","description":"Field name that caused the error","example":"tag_name","uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"description":{"type":"string","description":"Detailed error description","example":"tag_name cannot be empty","uniqueKey":"error.details.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INTERNAL","message":"Internal server error","details":[{"description":"An unexpected error occurred"}]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INTERNAL","message":"Internal server error","details":[{"description":"An unexpected error occurred"}]}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"3b831a39-e717-428e-81e8-008c413b83d9":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"02caac78-6882-428d-8ad3-7d5559dac04d":{"url":"https://api.coval.dev/v1","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"API key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/v1/tags-v1.yaml"},"subdomain":"coval-2e18a559","siteName":"Coval Documentation","title":"Get tag - Coval Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T17:40:11.102Z","originalFileLocation":"api-reference/tags/get-tag.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=\"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=\"description\" content=\"Retrieve a specific tag by its unique identifier.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Coval Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/coval-2e18a559/vkF1RiAFS33s2q-K/_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/coval-2e18a559/vkF1RiAFS33s2q-K/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/coval-2e18a559/vkF1RiAFS33s2q-K/_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/coval-2e18a559/vkF1RiAFS33s2q-K/_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/coval-2e18a559/vkF1RiAFS33s2q-K/_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/coval-2e18a559/vkF1RiAFS33s2q-K/_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/coval-2e18a559/vkF1RiAFS33s2q-K/_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/coval-2e18a559/vkF1RiAFS33s2q-K/_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/coval-2e18a559/vkF1RiAFS33s2q-K/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get tag - Coval Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a specific tag by its unique identifier.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Coval Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.coval.ai/api-reference/tags/get-tag\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://coval-2e18a559.mintlify.site/_mintlify/api/og/v2?division=Tags\u0026amp;title=Get+tag\u0026amp;description=Retrieve+a+specific+tag+by+its+unique+identifier.\u0026amp;theme=f645eaefd7d12d5c3c37070d\u0026amp;signature=3a95ba6c5efdcf106ec385eaa07ff66803407ef6d91a06d85d26cbf3fa01e123\">\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=\"Get tag - Coval Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a specific tag by its unique identifier.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://coval-2e18a559.mintlify.site/_mintlify/api/og/v2?division=Tags\u0026amp;title=Get+tag\u0026amp;description=Retrieve+a+specific+tag+by+its+unique+identifier.\u0026amp;theme=f645eaefd7d12d5c3c37070d\u0026amp;signature=3a95ba6c5efdcf106ec385eaa07ff66803407ef6d91a06d85d26cbf3fa01e123\">\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/coval-2e18a559/vkF1RiAFS33s2q-K/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Coval Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.coval.ai/api-reference/tags/get-tag\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tags/get-tag.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.coval.ai/#organization\",\"name\":\"Coval Documentation\",\"url\":\"https://docs.coval.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/coval-2e18a559/Notp6opJUCHArykW/logo/coval-logo-vector.svg?fit=max\u0026auto=format\u0026n=Notp6opJUCHArykW\u0026q=85\u0026s=f08474458e9c5bbff1e1d7119fdc8012\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.coval.ai#website\",\"name\":\"Coval Documentation\",\"url\":\"https://docs.coval.ai\",\"publisher\":{\"@id\":\"https://docs.coval.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.coval.ai/api-reference/tags/get-tag#webpage\",\"url\":\"https://docs.coval.ai/api-reference/tags/get-tag\",\"name\":\"Get tag\",\"description\":\"Retrieve a specific tag by its unique identifier.\",\"dateModified\":\"2026-10-27T17:40:11.102Z\",\"isPartOf\":{\"@id\":\"https://docs.coval.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.coval.ai/api-reference/tags/get-tag#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.coval.ai/api-reference/tags/get-tag#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tags\",\"item\":\"https://docs.coval.ai/api-reference/tags/list-tags\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get tag\",\"item\":\"https://docs.coval.ai/api-reference/tags/get-tag\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.coval.ai/api-reference/tags/get-tag#apireference\",\"headline\":\"Get tag\",\"name\":\"Get tag\",\"description\":\"Retrieve a specific tag by its unique identifier.\",\"url\":\"https://docs.coval.ai/api-reference/tags/get-tag\",\"mainEntityOfPage\":{\"@id\":\"https://docs.coval.ai/api-reference/tags/get-tag#webpage\"},\"dateModified\":\"2026-10-27T17:40:11.102Z\",\"publisher\":{\"@id\":\"https://docs.coval.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.coval.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Coval Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Coval Documentation","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/welcome"}]},{"tab":"API","icon":"square-terminal","groups":[{"group":"API","pages":[{"sidebarTitle":"Introduction","title":"API Reference","href":"/api-reference/v1/introduction"},{"title":"Conversation API compatibility","sidebarTitle":"Conversation compatibility","href":"/api-reference/v1/conversations-compatibility"}]},{"group":"Runs","icon":"play","pages":[{"title":"List runs","deprecated":null,"version":null,"openapi":"/api-reference/v1/runs-v1.yaml get /runs","href":"/api-reference/runs/list-runs"},{"title":"Launch run","deprecated":null,"version":null,"openapi":"/api-reference/v1/runs-v1.yaml post /runs","href":"/api-reference/runs/launch-run"},{"title":"Get run","deprecated":null,"version":null,"openapi":"/api-reference/v1/runs-v1.yaml get /runs/{run_id}","href":"/api-reference/runs/get-run"},{"title":"Update run","deprecated":null,"version":null,"openapi":"/api-reference/v1/runs-v1.yaml patch /runs/{run_id}","href":"/api-reference/runs/update-run"},{"title":"Delete run","deprecated":null,"version":null,"openapi":"/api-reference/v1/runs-v1.yaml delete /runs/{run_id}","href":"/api-reference/runs/delete-run"},{"title":"List run tag values","deprecated":null,"version":null,"openapi":"/api-reference/v1/runs-v1.yaml get /runs/tags","href":"/api-reference/runs/list-run-tag-values"}]},{"group":"Simulated Conversations","icon":"rocket","pages":[{"title":"List simulations","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /conversations/simulated","href":"/api-reference/simulated-conversations/list-simulations"},{"title":"Get simulation","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /conversations/simulated/{simulation_id}","href":"/api-reference/simulated-conversations/get-simulation"},{"title":"Update simulation","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml patch /conversations/simulated/{simulation_id}","href":"/api-reference/simulated-conversations/update-simulation"},{"title":"Delete or cancel simulation","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml delete /conversations/simulated/{simulation_id}","href":"/api-reference/simulated-conversations/delete-or-cancel-simulation"},{"title":"Batch rerun metrics","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml post /conversations/simulated:rerunMetrics","href":"/api-reference/simulated-conversations/batch-rerun-metrics"},{"title":"Discover SDK WebSocket connection","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /simulations/{simulation_id}/connect","href":"/api-reference/simulated-conversations/discover-sdk-websocket-connection"},{"title":"Rerun a simulation","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml post /conversations/simulated/{simulation_id}/resimulate","href":"/api-reference/simulated-conversations/rerun-a-simulation"},{"title":"Get audio file URL","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /conversations/simulated/{simulation_id}/audio","href":"/api-reference/simulated-conversations/get-audio-file-url"},{"title":"Retrieve a named simulation attribute","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /simulations/{simulation_id}/attributes/{attribute_name}","href":"/api-reference/simulated-conversations/retrieve-a-named-simulation-attribute"},{"group":"Metric Outputs","pages":[{"title":"List metrics","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /conversations/simulated/{simulation_id}/metrics","href":"/api-reference/metric-outputs/list-metrics"},{"title":"Get simulation metric output(s)","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /conversations/simulated/{simulation_id}/metrics/{metric_output_id}","href":"/api-reference/metric-outputs/get-simulation-metric-outputs"}]},{"group":"Conversation Comments","pages":[{"title":"List simulated conversation comments","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /conversations/simulated/{conversation_id}/comments","href":"/api-reference/conversation-comments/list-simulated-conversation-comments"},{"title":"Get a simulated conversation comment","deprecated":null,"version":null,"openapi":"/api-reference/v1/simulations-v1.yaml get /conversations/simulated/{conversation_id}/comments/{comment_id}","href":"/api-reference/conversation-comments/get-a-simulated-conversation-comment"}]}]},{"group":"Uploaded Conversations","icon":"messages","pages":[{"title":"Upload audio","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml post /audio:upload","href":"/api-reference/audio/upload-audio"},{"title":"Submit conversation for evaluation","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml post /conversations/uploaded:submit","href":"/api-reference/uploaded-conversations/submit-conversation-for-evaluation"},{"title":"List conversations","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml get /conversations/uploaded","href":"/api-reference/uploaded-conversations/list-conversations"},{"title":"Get conversation details","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml get /conversations/uploaded/{conversation_id}","href":"/api-reference/uploaded-conversations/get-conversation-details"},{"title":"Attach audio, add metadata, or assign an agent to a conversation","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml patch /conversations/uploaded/{conversation_id}","href":"/api-reference/uploaded-conversations/attach-audio-add-metadata-or-assign-an-agent-to-a-conversation"},{"title":"Delete or cancel conversation","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml delete /conversations/uploaded/{conversation_id}","href":"/api-reference/uploaded-conversations/delete-or-cancel-conversation"},{"title":"Get conversation audio","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml get /conversations/uploaded/{conversation_id}/audio","href":"/api-reference/audio/get-conversation-audio"},{"group":"Metrics","pages":[{"title":"List conversation metrics","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml get /conversations/uploaded/{conversation_id}/metrics","href":"/api-reference/uploaded-conversations/list-conversation-metrics"},{"title":"Get conversation metric output(s)","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml get /conversations/uploaded/{conversation_id}/metrics/{metric_output_id}","href":"/api-reference/uploaded-conversations/get-conversation-metric-outputs"}]},{"group":"Conversation Comments","pages":[{"title":"List uploaded conversation comments","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml get /conversations/uploaded/{conversation_id}/comments","href":"/api-reference/conversation-comments/list-uploaded-conversation-comments"},{"title":"Get a uploaded conversation comment","deprecated":null,"version":null,"openapi":"/api-reference/v1/conversations-v1.yaml get /conversations/uploaded/{conversation_id}/comments/{comment_id}","href":"/api-reference/conversation-comments/get-a-uploaded-conversation-comment"}]}]},{"group":"Agents","icon":"robot","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml get /agents","href":"/api-reference/agents/list-agents"},{"title":"Connect an agent","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml post /agents","href":"/api-reference/agents/connect-an-agent"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml get /agents/{agent_id}","href":"/api-reference/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml patch /agents/{agent_id}","href":"/api-reference/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml delete /agents/{agent_id}","href":"/api-reference/agents/delete-agent"},{"title":"Duplicate an agent","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml post /agents/{agent_id}/duplicate","href":"/api-reference/agents/duplicate-an-agent"},{"group":"Versions","pages":[{"title":"List agent versions","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml get /agents/{agent_id}/versions","href":"/api-reference/agents/list-agent-versions"},{"title":"Revert agent version","deprecated":null,"version":null,"openapi":"/api-reference/v1/agents-v1.yaml post /agents/{agent_id}/versions/{version_id}/revert","href":"/api-reference/agents/revert-agent-version"}]}]},{"group":"Mutations","icon":"flask-vial","pages":[{"title":"List mutations","deprecated":null,"version":null,"openapi":"/api-reference/v1/mutations-v1.yaml get /agents/{agent_id}/mutations","href":"/api-reference/mutations/list-mutations"},{"title":"Create mutation","deprecated":null,"version":null,"openapi":"/api-reference/v1/mutations-v1.yaml post /agents/{agent_id}/mutations","href":"/api-reference/mutations/create-mutation"},{"title":"Get mutation","deprecated":null,"version":null,"openapi":"/api-reference/v1/mutations-v1.yaml get /agents/{agent_id}/mutations/{mutation_id}","href":"/api-reference/mutations/get-mutation"},{"title":"Update mutation","deprecated":null,"version":null,"openapi":"/api-reference/v1/mutations-v1.yaml patch /agents/{agent_id}/mutations/{mutation_id}","href":"/api-reference/mutations/update-mutation"},{"title":"Delete mutation","deprecated":null,"version":null,"openapi":"/api-reference/v1/mutations-v1.yaml delete /agents/{agent_id}/mutations/{mutation_id}","href":"/api-reference/mutations/delete-mutation"}]},{"group":"Test Sets","icon":"database","pages":[{"title":"List test sets","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml get /test-sets","href":"/api-reference/test-sets/list-test-sets"},{"title":"Create test set","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml post /test-sets","href":"/api-reference/test-sets/create-test-set"},{"title":"Get test set","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml get /test-sets/{test_set_id}","href":"/api-reference/test-sets/get-test-set"},{"title":"Update test set","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml patch /test-sets/{test_set_id}","href":"/api-reference/test-sets/update-test-set"},{"title":"Delete test set","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml delete /test-sets/{test_set_id}","href":"/api-reference/test-sets/delete-test-set"},{"title":"Duplicate a test set","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml post /test-sets/{test_set_id}/duplicate","href":"/api-reference/test-sets/duplicate-a-test-set"},{"title":"Associate agents with a test set","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml post /test-sets/{test_set_id}/agents:add","href":"/api-reference/test-sets/associate-agents-with-a-test-set"},{"title":"List test set records","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml get /test-sets/{test_set_id}/records","href":"/api-reference/test-sets/list-test-set-records"},{"group":"Versions","pages":[{"title":"List test set versions","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml get /test-sets/{test_set_id}/versions","href":"/api-reference/test-sets/list-test-set-versions"},{"title":"Revert test set version","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml post /test-sets/{test_set_id}/versions/{version_id}/revert","href":"/api-reference/test-sets/revert-test-set-version"}]},{"group":"Agents","pages":[{"title":"List associated agents","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml get /test-sets/{test_set_id}/agents","href":"/api-reference/test-sets/list-associated-agents"},{"title":"Remove an agent association","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-sets-v1.yaml delete /test-sets/{test_set_id}/agents/{agent_id}","href":"/api-reference/test-sets/remove-an-agent-association"}]}]},{"group":"Test Cases","icon":"flask","pages":[{"title":"List test cases","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-cases-v1.yaml get /test-cases","href":"/api-reference/test-cases/list-test-cases"},{"title":"Create test case","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-cases-v1.yaml post /test-cases","href":"/api-reference/test-cases/create-test-case"},{"title":"Get test case","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-cases-v1.yaml get /test-cases/{test_case_id}","href":"/api-reference/test-cases/get-test-case"},{"title":"Update test case","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-cases-v1.yaml patch /test-cases/{test_case_id}","href":"/api-reference/test-cases/update-test-case"},{"title":"Delete test case","deprecated":null,"version":null,"openapi":"/api-reference/v1/test-cases-v1.yaml delete /test-cases/{test_case_id}","href":"/api-reference/test-cases/delete-test-case"}]},{"group":"Personas","icon":"circle-user","pages":[{"title":"List personas","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml get /personas","href":"/api-reference/personas/list-personas"},{"title":"Create persona","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml post /personas","href":"/api-reference/personas/create-persona"},{"title":"Get persona","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml get /personas/{persona_id}","href":"/api-reference/personas/get-persona"},{"title":"Update persona","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml patch /personas/{persona_id}","href":"/api-reference/personas/update-persona"},{"title":"Delete persona","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml delete /personas/{persona_id}","href":"/api-reference/personas/delete-persona"},{"title":"List background sounds","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml get /personas/background-sounds","href":"/api-reference/personas/list-background-sounds"},{"title":"Create background sound upload","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml post /personas/background-sounds","href":"/api-reference/personas/create-background-sound-upload"},{"title":"Update background sound","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml patch /personas/background-sounds/{background_sound_id}","href":"/api-reference/personas/update-background-sound"},{"title":"List phone number mappings","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml get /personas/phone-numbers","href":"/api-reference/personas/list-phone-number-mappings"},{"title":"List available voices","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml get /personas/voices","href":"/api-reference/personas/list-available-voices"},{"title":"List persona tag values","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml get /personas/tags","href":"/api-reference/personas/list-persona-tag-values"},{"title":"Duplicate a persona","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml post /personas/{persona_id}/duplicate","href":"/api-reference/personas/duplicate-a-persona"},{"title":"Complete background sound upload","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml post /personas/background-sounds/{background_sound_id}/complete","href":"/api-reference/personas/complete-background-sound-upload"},{"group":"Versions","pages":[{"title":"List persona versions","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml get /personas/{persona_id}/versions","href":"/api-reference/personas/list-persona-versions"},{"title":"Revert persona version","deprecated":null,"version":null,"openapi":"/api-reference/v1/personas-v1.yaml post /personas/{persona_id}/versions/{version_id}/revert","href":"/api-reference/personas/revert-persona-version"}]}]},{"group":"Metrics","icon":"ballot-check","pages":[{"title":"List metrics","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics","href":"/api-reference/metrics/list-metrics"},{"title":"Create metric","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics","href":"/api-reference/metrics/create-metric"},{"title":"List metric template variables","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/template-variables","href":"/api-reference/metrics/list-metric-template-variables"},{"title":"Get metric","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/{metric_id}","href":"/api-reference/metrics/get-metric"},{"title":"Update metric","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml patch /metrics/{metric_id}","href":"/api-reference/metrics/update-metric"},{"title":"Delete metric","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml delete /metrics/{metric_id}","href":"/api-reference/metrics/delete-metric"},{"title":"List recently-deleted metrics","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/recently-deleted","href":"/api-reference/metrics/list-recently-deleted-metrics"},{"title":"List available metric models","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /models/metric","href":"/api-reference/metrics/list-available-metric-models"},{"title":"List metric flows","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/flows","href":"/api-reference/metrics/list-metric-flows"},{"title":"Create a metric flow","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/flows","href":"/api-reference/metrics/create-a-metric-flow"},{"title":"Update a metric flow","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml patch /metrics/flows/{flow_id}","href":"/api-reference/metrics/update-a-metric-flow"},{"title":"Delete a metric flow","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml delete /metrics/flows/{flow_id}","href":"/api-reference/metrics/delete-a-metric-flow"},{"title":"Test a draft SQL metric query","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/sql:test","href":"/api-reference/metrics/test-a-draft-sql-metric-query"},{"title":"Get the SQL metric schema","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/sql-schema","href":"/api-reference/metrics/get-the-sql-metric-schema"},{"title":"Batch-get metric outputs by ULID","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/outputs:batchGet","href":"/api-reference/metrics/batch-get-metric-outputs-by-ulid"},{"title":"List metric tag values","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/tags","href":"/api-reference/metrics/list-metric-tag-values"},{"title":"Duplicate a metric","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/{metric_id}/duplicate","href":"/api-reference/metrics/duplicate-a-metric"},{"title":"Restore a recently-deleted metric","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/{metric_id}/restore","href":"/api-reference/metrics/restore-a-recently-deleted-metric"},{"title":"Trigger test metric execution","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/{metric_id}/test","href":"/api-reference/metrics/trigger-test-metric-execution"},{"group":"Versions","pages":[{"title":"List metric versions","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/{metric_id}/versions","href":"/api-reference/metrics/list-metric-versions"},{"title":"Revert metric version","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/{metric_id}/versions/{version_id}/revert","href":"/api-reference/metrics/revert-metric-version"}]},{"group":"Thresholds","pages":[{"title":"List metric thresholds","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/{metric_id}/thresholds","href":"/api-reference/metrics/list-metric-thresholds"},{"title":"Create metric threshold","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/{metric_id}/thresholds","href":"/api-reference/metrics/create-metric-threshold"},{"title":"Get metric threshold","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/{metric_id}/threshold","href":"/api-reference/metrics/get-metric-threshold"},{"title":"Update metric threshold","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml patch /metrics/{metric_id}/threshold","href":"/api-reference/metrics/update-metric-threshold"},{"title":"Delete metric threshold","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml delete /metrics/{metric_id}/thresholds/{threshold_id}","href":"/api-reference/metrics/delete-metric-threshold"}]},{"group":"Baselines","pages":[{"title":"List metric baselines","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/{metric_id}/baselines","href":"/api-reference/metrics/list-metric-baselines"},{"title":"Create metric baseline","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml post /metrics/{metric_id}/baselines","href":"/api-reference/metrics/create-metric-baseline"},{"title":"Get metric baseline","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/{metric_id}/baselines/{baseline_id}","href":"/api-reference/metrics/get-metric-baseline"},{"title":"Update metric baseline","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml patch /metrics/{metric_id}/baselines/{baseline_id}","href":"/api-reference/metrics/update-metric-baseline"},{"title":"Delete metric baseline","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml delete /metrics/{metric_id}/baselines/{baseline_id}","href":"/api-reference/metrics/delete-metric-baseline"},{"title":"Get baseline history","deprecated":null,"version":null,"openapi":"/api-reference/v1/metrics-v1.yaml get /metrics/{metric_id}/baselines/{baseline_id}/history","href":"/api-reference/metrics/get-baseline-history"}]}]},{"group":"Run Templates","icon":"puzzle-piece","pages":[{"title":"List run templates","deprecated":null,"version":null,"openapi":"/api-reference/v1/run-templates-v1.yaml get /run-templates","href":"/api-reference/run-templates/list-run-templates"},{"title":"Create run template","deprecated":null,"version":null,"openapi":"/api-reference/v1/run-templates-v1.yaml post /run-templates","href":"/api-reference/run-templates/create-run-template"},{"title":"Get run template","deprecated":null,"version":null,"openapi":"/api-reference/v1/run-templates-v1.yaml get /run-templates/{run_template_id}","href":"/api-reference/run-templates/get-run-template"},{"title":"Update run template","deprecated":null,"version":null,"openapi":"/api-reference/v1/run-templates-v1.yaml patch /run-templates/{run_template_id}","href":"/api-reference/run-templates/update-run-template"},{"title":"Delete run template","deprecated":null,"version":null,"openapi":"/api-reference/v1/run-templates-v1.yaml delete /run-templates/{run_template_id}","href":"/api-reference/run-templates/delete-run-template"}]},{"group":"Scheduled Runs","icon":"clock","pages":[{"title":"List scheduled runs","deprecated":null,"version":null,"openapi":"/api-reference/v1/scheduled-runs-v1.yaml get /scheduled-runs","href":"/api-reference/scheduled-runs/list-scheduled-runs"},{"title":"Create scheduled run","deprecated":null,"version":null,"openapi":"/api-reference/v1/scheduled-runs-v1.yaml post /scheduled-runs","href":"/api-reference/scheduled-runs/create-scheduled-run"},{"title":"Get scheduled run","deprecated":null,"version":null,"openapi":"/api-reference/v1/scheduled-runs-v1.yaml get /scheduled-runs/{scheduled_run_id}","href":"/api-reference/scheduled-runs/get-scheduled-run"},{"title":"Update scheduled run","deprecated":null,"version":null,"openapi":"/api-reference/v1/scheduled-runs-v1.yaml patch /scheduled-runs/{scheduled_run_id}","href":"/api-reference/scheduled-runs/update-scheduled-run"},{"title":"Delete scheduled run","deprecated":null,"version":null,"openapi":"/api-reference/v1/scheduled-runs-v1.yaml delete /scheduled-runs/{scheduled_run_id}","href":"/api-reference/scheduled-runs/delete-scheduled-run"},{"title":"List a scheduled run's produced runs","deprecated":null,"version":null,"openapi":"/api-reference/v1/scheduled-runs-v1.yaml get /scheduled-runs/{scheduled_run_id}/runs","href":"/api-reference/scheduled-runs/list-a-scheduled-runs-produced-runs"}]},{"group":"Reviews","icon":"clipboard-check","pages":[{"title":"List review annotations","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-annotations","href":"/api-reference/review-annotations/list-review-annotations"},{"title":"Create review annotation","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml post /review-annotations","href":"/api-reference/review-annotations/create-review-annotation"},{"title":"Get review annotation","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-annotations/{annotation_id}","href":"/api-reference/review-annotations/get-review-annotation"},{"title":"Update review annotation","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml patch /review-annotations/{annotation_id}","href":"/api-reference/review-annotations/update-review-annotation"},{"title":"Delete review annotation","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml delete /review-annotations/{annotation_id}","href":"/api-reference/review-annotations/delete-review-annotation"},{"title":"List review projects","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-projects","href":"/api-reference/review-projects/list-review-projects"},{"title":"Create review project","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml post /review-projects","href":"/api-reference/review-projects/create-review-project"},{"title":"Get review project","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-projects/{project_id}","href":"/api-reference/review-projects/get-review-project"},{"title":"Update review project","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml patch /review-projects/{project_id}","href":"/api-reference/review-projects/update-review-project"},{"title":"Delete review project","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml delete /review-projects/{project_id}","href":"/api-reference/review-projects/delete-review-project"},{"title":"Get review disagreement state","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml post /review-projects/disagreement-state","href":"/api-reference/review-projects/get-review-disagreement-state"},{"title":"Get metric health stats","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-annotations/metric-health-stats","href":"/api-reference/review-annotations/get-metric-health-stats"},{"title":"Get annotations with metric outputs","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml post /review-annotations:withMetricOutputs","href":"/api-reference/review-annotations/get-annotations-with-metric-outputs"},{"title":"Get project metric agreement","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-projects/{project_id}/metric-agreement","href":"/api-reference/review-projects/get-project-metric-agreement"},{"title":"Get review project progress","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-projects/{project_id}/progress","href":"/api-reference/review-projects/get-review-project-progress"},{"title":"Get project insights","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml get /review-projects/{project_id}/insights","href":"/api-reference/review-projects/get-project-insights"},{"title":"Complete a review-project conversation","deprecated":null,"version":null,"openapi":"/api-reference/v1/reviews-v1.yaml post /review-projects/{project_id}/complete-conversation","href":"/api-reference/review-projects/complete-a-review-project-conversation"}]},{"group":"Dashboards","icon":"chart-line","pages":[{"title":"List dashboards","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml get /dashboards","href":"/api-reference/dashboards/list-dashboards"},{"title":"Create dashboard","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml post /dashboards","href":"/api-reference/dashboards/create-dashboard"},{"title":"Get dashboard","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml get /dashboards/{dashboard_id}","href":"/api-reference/dashboards/get-dashboard"},{"title":"Update dashboard","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml patch /dashboards/{dashboard_id}","href":"/api-reference/dashboards/update-dashboard"},{"title":"Delete dashboard","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml delete /dashboards/{dashboard_id}","href":"/api-reference/dashboards/delete-dashboard"},{"group":"Widgets","pages":[{"title":"List widgets","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml get /dashboards/{dashboard_id}/widgets","href":"/api-reference/widgets/list-widgets"},{"title":"Create widget","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml post /dashboards/{dashboard_id}/widgets","href":"/api-reference/widgets/create-widget"},{"title":"Get widget","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml get /dashboards/{dashboard_id}/widgets/{widget_id}","href":"/api-reference/widgets/get-widget"},{"title":"Update widget","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml patch /dashboards/{dashboard_id}/widgets/{widget_id}","href":"/api-reference/widgets/update-widget"},{"title":"Delete widget","deprecated":null,"version":null,"openapi":"/api-reference/v1/dashboards-v1.yaml delete /dashboards/{dashboard_id}/widgets/{widget_id}","href":"/api-reference/widgets/delete-widget"}]}]},{"group":"Alerts","icon":"bell","pages":[{"title":"List alerts","deprecated":null,"version":null,"openapi":"/api-reference/v1/alerts-v1.yaml get /alerts","href":"/api-reference/alerts/list-alerts"},{"title":"Create an alert","deprecated":null,"version":null,"openapi":"/api-reference/v1/alerts-v1.yaml post /alerts","href":"/api-reference/alerts/create-an-alert"},{"title":"Get an alert","deprecated":null,"version":null,"openapi":"/api-reference/v1/alerts-v1.yaml get /alerts/{alert_id}","href":"/api-reference/alerts/get-an-alert"},{"title":"Update an alert","deprecated":null,"version":null,"openapi":"/api-reference/v1/alerts-v1.yaml patch /alerts/{alert_id}","href":"/api-reference/alerts/update-an-alert"},{"title":"Delete an alert","deprecated":null,"version":null,"openapi":"/api-reference/v1/alerts-v1.yaml delete /alerts/{alert_id}","href":"/api-reference/alerts/delete-an-alert"},{"title":"List alert events","deprecated":null,"version":null,"openapi":"/api-reference/v1/alerts-v1.yaml get /alerts/{alert_id}/events","href":"/api-reference/alert-events/list-alert-events"},{"title":"Test evaluate an alert","deprecated":null,"version":null,"openapi":"/api-reference/v1/alerts-v1.yaml post /alerts/{alert_id}/test-evaluate","href":"/api-reference/alerts/test-evaluate-an-alert"}]},{"group":"Reports","icon":"file-chart-column","pages":[{"title":"List reports","deprecated":null,"version":null,"openapi":"/api-reference/v1/reports-v1.yaml get /reports","href":"/api-reference/reports/list-reports"},{"title":"Create report","deprecated":null,"version":null,"openapi":"/api-reference/v1/reports-v1.yaml post /reports","href":"/api-reference/reports/create-report"},{"title":"Get report","deprecated":null,"version":null,"openapi":"/api-reference/v1/reports-v1.yaml get /reports/{report_id}","href":"/api-reference/reports/get-report"},{"title":"Update report","deprecated":null,"version":null,"openapi":"/api-reference/v1/reports-v1.yaml patch /reports/{report_id}","href":"/api-reference/reports/update-report"},{"title":"Delete report","deprecated":null,"version":null,"openapi":"/api-reference/v1/reports-v1.yaml delete /reports/{report_id}","href":"/api-reference/reports/delete-report"},{"title":"List report rows","deprecated":null,"version":null,"openapi":"/api-reference/v1/reports-v1.yaml get /reports/{report_id}/rows","href":"/api-reference/reports/list-report-rows"}]},{"group":"Tags","icon":"tags","pages":[{"title":"List tags","deprecated":null,"version":null,"openapi":"/api-reference/v1/tags-v1.yaml get /tags","href":"/api-reference/tags/list-tags"},{"title":"Create tag","description":"Create a new tag. Tag names are normalized to lowercase before persistence.\nReturns 409 if a tag with the same name already exists and is active.\nReusing a deleted name reactivates the same tag without restoring prior assignments.\n","deprecated":null,"version":null,"openapi":"/api-reference/v1/tags-v1.yaml post /tags","href":"/api-reference/tags/create-tag"},{"title":"Get tag","deprecated":null,"version":null,"openapi":"/api-reference/v1/tags-v1.yaml get /tags/{tag_id}","href":"/api-reference/tags/get-tag"},{"title":"Update tag","description":"Update a tag's name or color. Only provided fields are updated.\nTag names are normalized to lowercase before persistence.\n","deprecated":null,"version":null,"openapi":"/api-reference/v1/tags-v1.yaml patch /tags/{tag_id}","href":"/api-reference/tags/update-tag"},{"title":"Delete tag","deprecated":null,"version":null,"openapi":"/api-reference/v1/tags-v1.yaml delete /tags/{tag_id}","href":"/api-reference/tags/delete-tag"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/api-reference/v1/webhooks-v1.yaml get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/api-reference/v1/webhooks-v1.yaml post /webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"/api-reference/v1/webhooks-v1.yaml patch /webhooks/{webhook_id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"/api-reference/v1/webhooks-v1.yaml delete /webhooks/{webhook_id}","href":"/api-reference/webhooks/delete-a-webhook"}]},{"group":"Traces","icon":"bezier-curve","pages":[{"title":"Ingest OTLP traces","deprecated":null,"version":null,"openapi":"/api-reference/v1/traces-v1.yaml post /traces","href":"/api-reference/traces/ingest-otlp-traces"},{"title":"Search trace-bearing calls","deprecated":null,"version":null,"openapi":"/api-reference/v1/traces-v1.yaml post /traces/search","href":"/api-reference/traces/search-trace-bearing-calls"},{"title":"Inspect trace quality and signal coverage","deprecated":null,"version":null,"openapi":"/api-reference/v1/traces-v1.yaml get /traces/summary","href":"/api-reference/traces/inspect-trace-quality-and-signal-coverage"},{"title":"List trace spans for a simulation output","deprecated":null,"version":null,"openapi":"/api-reference/v1/traces-v1.yaml get /traces/spans","href":"/api-reference/traces/list-trace-spans-for-a-simulation-output"}]},{"group":"Conversations Config","icon":"building","pages":[{"title":"List organization users","deprecated":null,"version":null,"openapi":"/api-reference/v1/organization-v1.yaml get /organization/users","href":"/api-reference/organization-users/list-organization-users"},{"title":"Get conversation metrics config","deprecated":null,"version":null,"openapi":"/api-reference/v1/organization-v1.yaml get /organization/conversation-metrics","href":"/api-reference/organization-conversations-config/get-conversation-metrics-config"},{"title":"Update conversation metrics config","deprecated":null,"version":null,"openapi":"/api-reference/v1/organization-v1.yaml patch /organization/conversation-metrics","href":"/api-reference/organization-conversations-config/update-conversation-metrics-config"},{"title":"Get conversation metrics config using the legacy path","deprecated":true,"version":null,"openapi":"/api-reference/v1/organization-v1.yaml get /organization/monitoring-metrics","href":"/api-reference/organization-conversations-config/get-conversation-metrics-config-using-the-legacy-path"},{"title":"Update conversation metrics config using the legacy path","deprecated":true,"version":null,"openapi":"/api-reference/v1/organization-v1.yaml patch /organization/monitoring-metrics","href":"/api-reference/organization-conversations-config/update-conversation-metrics-config-using-the-legacy-path"}]},{"group":"API Keys","icon":"key","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/v1/api-keys-v1.yaml get /api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create API key","deprecated":null,"version":null,"openapi":"/api-reference/v1/api-keys-v1.yaml post /api-keys","href":"/api-reference/api-keys/create-api-key"},{"title":"Update API key status","deprecated":null,"version":null,"openapi":"/api-reference/v1/api-keys-v1.yaml patch /api-keys/{api_key_id}","href":"/api-reference/api-keys/update-api-key-status"},{"title":"Delete API key","deprecated":null,"version":null,"openapi":"/api-reference/v1/api-keys-v1.yaml delete /api-keys/{api_key_id}","href":"/api-reference/api-keys/delete-api-key"}]},{"group":"Workspaces","icon":"layer-group","pages":[{"title":"List workspaces","deprecated":null,"version":null,"openapi":"/api-reference/v1/workspaces-v1.yaml get /workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Create workspace","deprecated":null,"version":null,"openapi":"/api-reference/v1/workspaces-v1.yaml post /workspaces","href":"/api-reference/workspaces/create-workspace"},{"title":"Get workspace","deprecated":null,"version":null,"openapi":"/api-reference/v1/workspaces-v1.yaml get /workspaces/{workspace_id}","href":"/api-reference/workspaces/get-workspace"},{"title":"Update workspace","deprecated":null,"version":null,"openapi":"/api-reference/v1/workspaces-v1.yaml patch /workspaces/{workspace_id}","href":"/api-reference/workspaces/update-workspace"},{"title":"Delete workspace","deprecated":null,"version":null,"openapi":"/api-reference/v1/workspaces-v1.yaml delete /workspaces/{workspace_id}","href":"/api-reference/workspaces/delete-workspace"},{"title":"Archive workspace","deprecated":null,"version":null,"openapi":"/api-reference/v1/workspaces-v1.yaml post /workspaces/{workspace_id}/archive","href":"/api-reference/workspaces/archive-workspace"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"Get Slack integration status","deprecated":null,"version":null,"openapi":"/api-reference/v1/slack-v1.yaml get /integrations/slack","href":"/api-reference/integrations/get-slack-integration-status"},{"title":"Disconnect Slack integration","deprecated":null,"version":null,"openapi":"/api-reference/v1/slack-v1.yaml delete /integrations/slack","href":"/api-reference/integrations/disconnect-slack-integration"},{"title":"Connect a Slack workspace","deprecated":null,"version":null,"openapi":"/api-reference/v1/slack-v1.yaml post /integrations/slack/connect","href":"/api-reference/integrations/connect-a-slack-workspace"}]}]},{"tab":"CLI","icon":"terminal","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"Developers","icon":"code","pages":[{"title":"Developers","href":"/sdks/overview"}]},{"tab":"Agents","icon":"microchip","pages":[{"title":"Agents","href":"/agents/overview"}]},{"tab":"Connectors","icon":"diagram-project","pages":[{"title":"Connectors","href":"/mcp/overview"}]}]},"basePath":"","title":"Get tag - Coval Documentation","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}