{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chainloop Documentation","description":"Chainloop is the trust infrastructure for AI-driven software delivery. It collects signed, tamper-evident evidence from every build, release and AI coding session, enforces policies as code inside your CI/CD pipelines, and turns that evidence into continuous compliance. The core is open source.","colors":{"primary":"#2D1BD2","light":"#FF5C4D","dark":"#9F8951"},"logo":{"light":"https://mintcdn.com/chainloop/piBVJM34fSFTGk0R/images/logo/light.svg?fit=max\u0026auto=format\u0026n=piBVJM34fSFTGk0R\u0026q=85\u0026s=4bc355683f7e78c629ece2e28db71dff","dark":"https://mintcdn.com/chainloop/xJ5hNAgMrS6U1u_m/images/logo/dark.png?fit=max\u0026auto=format\u0026n=xJ5hNAgMrS6U1u_m\u0026q=85\u0026s=9e6be3ff192adebcb1f8fda40d07f9e4","href":"https://chainloop.dev/"},"favicon":"https://mintcdn.com/chainloop/yJa2Iopv98OPg1FZ/images/favicon/favicon-32x32.png?fit=max\u0026auto=format\u0026n=yJa2Iopv98OPg1FZ\u0026q=85\u0026s=1a0b74dcba7ec787f8ed05421f617d11","navbar":{"primary":{"type":"button","label":"Get a demo","href":"https://chainloop.dev/book-a-demo"}},"footer":{"socials":{"slack":"https://join.slack.com/t/chainloop-community/shared_invite/zt-2k34dvx3r-u85uGP_KiLC6ic5Wy4aRnQ","github":"https://github.com/chainloop-dev","x":"https://x.com/chainloop_dev","linkedin":"https://www.linkedin.com/company/chainloop-dev","youtube":"https://www.youtube.com/@chainloop-dev"}},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":false},"integrations":{"intercom":{"appId":"t3644vit"},"posthog":{"apiKey":"phc_rCvU7fL4Ndr4GpzH54RNdyNUWNgTpuHX7ApDxFW6G9FS","apiHost":"https://t.chainloop.dev"},"cookies":{"key":"chainloop_analytics_consent","value":"granted"}},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://chainloop.dev/"},{"anchor":"Blog","icon":"newspaper","href":"https://chainloop.dev/blog"},{"anchor":"Get Help","icon":"headset","href":"https://help.chainloop.dev"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chainloop","hasAudioNarration":false,"actualSubdomain":"chainloop","customDomains":["docs.chainloop.dev"],"gitSource":{"type":"github","owner":"chainloop-dev","repo":"platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aed3decf88157910e0ba70c","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Documentation","count":90},{"language":"default","tag":"Reference","count":65},{"language":"default","tag":"API Reference","count":62},{"language":"default","tag":"Platform Endpoints","count":59},{"language":"default","tag":"Guides","count":40},{"language":"default","tag":"Concepts","count":23},{"language":"default","tag":"References","count":17},{"language":"default","tag":"Deployment","count":15},{"language":"default","tag":"Configuration Guides","count":12},{"language":"default","tag":"AssessmentService","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":[],"page":{"pagePath":"api-reference/findingservice/describe-a-finding","slug":"/api-reference/findingservice/describe-a-finding","pageMetadata":{"title":"Describe a finding","description":"Get detailed information about a specific security finding.","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/findings/{finding_id}","href":"/api-reference/findingservice/describe-a-finding","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: \"Get detailed information about a specific security finding.\"\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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Describe a finding","description":"Get detailed information about a specific security finding.","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/findings/{finding_id}","href":"/api-reference/findingservice/describe-a-finding","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/chainloop/253f77efa74d603b/cioanalytics.js","/_mintlify/custom/chainloop/86afb8ad5e3e2752/banner-expiry.js","/_mintlify/custom/chainloop/6873c2c42265ece7/hubspot.js","/_mintlify/custom/chainloop/f6648ff7bc1812af/termly.js"],"openApiReferenceData":{"operation":{"description":"Get detailed information about a specific security finding.","operationId":"FindingService_Describe","parameters":["be150f15-94f4-402c-af4f-04d60d8de4bd"],"responses":{"200":"25ff72b2-77c0-47bb-8e95-01efe0cadc4c","400":"603d47c8-b123-4adb-a573-16b9015a5381","401":"307429d5-6ecc-49c8-9be2-b44f7404df83","403":"1b62b415-b56c-4dbb-ab90-e8dba9c5c3a9","500":"20b3334f-4a7f-49a0-9caa-ff486454f927","default":"e86abaf3-f125-44a1-aa01-bcee620ed574"},"summary":"Describe a finding","tags":["FindingService"],"method":"get","type":"path","servers":["cffda803-c383-4264-b179-18063a2c0f46"],"security":["ace5891d-f278-4089-9e45-73c99269d5ad"],"path":"/v1/findings/{finding_id}","baseUrlOptions":["https://api.app.chainloop.dev/"],"title":"Describe a finding","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"be150f15-94f4-402c-af4f-04d60d8de4bd":{"description":"ID of the finding","in":"path","name":"finding_id","required":true,"schema":{"type":"string","isRequired":true,"description":"ID of the finding","uniqueKey":"","typeLabel":"string"}}},"responses":{"25ff72b2-77c0-47bb-8e95-01efe0cadc4c":{"content":{"application/json":{"schema":{"description":"Response for the Describe method","example":{"result":{"reports":[{"evidence":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"fixed":true},{"evidence":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"fixed":true}],"package_purl":"package_purl","fixed_in_id":"fixed_in_id","status_changed_at":"2000-01-23T04:56:07.000Z","recommendation":"recommendation","created_at":"2000-01-23T04:56:07.000Z","external_id":"external_id","source":"source","project_name":"project_name","needs_review":true,"first_seen_in_id":"first_seen_in_id","project_version_name":"project_version_name","updated_at":"2000-01-23T04:56:07.000Z","last_seen_in_id":"last_seen_in_id","assessment_ids":["assessment_ids","assessment_ids"],"details":"{}","id":"id","severity":"FINDING_SEVERITY_UNSPECIFIED","source_format":"source_format","component_id":"component_id","is_in_kev":true,"first_seen_at":"2000-01-23T04:56:07.000Z","vulnerability":{"is_in_kev":true,"description":"description","external_id":"external_id","id":"id","cwes":["cwes","cwes"],"cvss_vectors":["cvss_vectors","cvss_vectors"]},"finding_type":"FINDING_TYPE_UNSPECIFIED","has_conflicting_assessments":true,"status_detail":"FINDING_STATUS_DETAIL_UNSPECIFIED","resolution_reason":"FINDING_RESOLUTION_REASON_UNSPECIFIED","fixed_version":"fixed_version","resolved_at":"2000-01-23T04:56:07.000Z","artifact_ids":["artifact_ids","artifact_ids"],"location":"location","effective_assessment_status":"ASSESSMENT_STATUS_UNSPECIFIED","last_seen_at":"2000-01-23T04:56:07.000Z","effective_assessment_id":"effective_assessment_id","status":"FINDING_STATUS_UNSPECIFIED"}},"properties":{"result":{"description":"Full details of a security finding","example":{"reports":[{"evidence":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"fixed":true},{"evidence":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"fixed":true}],"package_purl":"package_purl","fixed_in_id":"fixed_in_id","status_changed_at":"2000-01-23T04:56:07.000Z","recommendation":"recommendation","created_at":"2000-01-23T04:56:07.000Z","external_id":"external_id","source":"source","project_name":"project_name","needs_review":true,"first_seen_in_id":"first_seen_in_id","project_version_name":"project_version_name","updated_at":"2000-01-23T04:56:07.000Z","last_seen_in_id":"last_seen_in_id","assessment_ids":["assessment_ids","assessment_ids"],"details":"{}","id":"id","severity":"FINDING_SEVERITY_UNSPECIFIED","source_format":"source_format","component_id":"component_id","is_in_kev":true,"first_seen_at":"2000-01-23T04:56:07.000Z","vulnerability":{"is_in_kev":true,"description":"description","external_id":"external_id","id":"id","cwes":["cwes","cwes"],"cvss_vectors":["cvss_vectors","cvss_vectors"]},"finding_type":"FINDING_TYPE_UNSPECIFIED","has_conflicting_assessments":true,"status_detail":"FINDING_STATUS_DETAIL_UNSPECIFIED","resolution_reason":"FINDING_RESOLUTION_REASON_UNSPECIFIED","fixed_version":"fixed_version","resolved_at":"2000-01-23T04:56:07.000Z","artifact_ids":["artifact_ids","artifact_ids"],"location":"location","effective_assessment_status":"ASSESSMENT_STATUS_UNSPECIFIED","last_seen_at":"2000-01-23T04:56:07.000Z","effective_assessment_id":"effective_assessment_id","status":"FINDING_STATUS_UNSPECIFIED"},"properties":{"id":{"description":"Unique identifier","title":"Unique identifier","type":"string","uniqueKey":"result.id","typeLabel":"string"},"external_id":{"description":"Vulnerability or finding identifier","title":"External identifier (e.g. CVE-2024-1234)","type":"string","uniqueKey":"result.external_id","typeLabel":"string"},"package_purl":{"description":"Affected package in PURL format","title":"Affected package in PURL format","type":"string","uniqueKey":"result.package_purl","typeLabel":"string"},"finding_type":{"default":"FINDING_TYPE_UNSPECIFIED","description":"FindingType represents the type of security finding. Lives in\nshared_messages.proto for the same reason as FindingSeverity:\nassessment.proto needs it for the ListEffective query tuples without\ncreating an import cycle with finding.proto.","enum":["FINDING_TYPE_UNSPECIFIED","FINDING_TYPE_VULNERABILITY"],"type":"string","uniqueKey":"result.finding_type","typeLabel":"enum\u003cstring>"},"severity":{"default":"FINDING_SEVERITY_UNSPECIFIED","description":"FindingSeverity represents the severity level of a finding. Lives in\nshared_messages.proto so both finding.proto and assessment.proto can use it\nwithout creating an import cycle (finding.proto imports assessment.proto for\nAssessmentStatus, and assessment.proto needs FindingSeverity for the\nseverity field on AssessmentItem).","enum":["FINDING_SEVERITY_UNSPECIFIED","FINDING_SEVERITY_CRITICAL","FINDING_SEVERITY_HIGH","FINDING_SEVERITY_MEDIUM","FINDING_SEVERITY_LOW","FINDING_SEVERITY_INFO","FINDING_SEVERITY_UNKNOWN"],"type":"string","uniqueKey":"result.severity","typeLabel":"enum\u003cstring>"},"status":{"default":"FINDING_STATUS_UNSPECIFIED","description":"FindingStatus represents the lifecycle status of a finding.\nTransitions: OPEN → IN_PROGRESS → RESOLVED, or OPEN → REJECTED.\nA resolved finding can be reopened (back to OPEN) if it reappears in later evidence.\n\n - FINDING_STATUS_OPEN: OPEN: newly detected finding, not yet triaged or acted upon\n - FINDING_STATUS_IN_PROGRESS: IN_PROGRESS: finding is being investigated or actively remediated\n - FINDING_STATUS_RESOLVED: RESOLVED: finding has been fixed, mitigated, or otherwise closed (see resolution_reason for details)\n - FINDING_STATUS_REJECTED: REJECTED: finding has been dismissed by an operator (e.g. false positive, risk accepted, out of scope)","enum":["FINDING_STATUS_UNSPECIFIED","FINDING_STATUS_OPEN","FINDING_STATUS_IN_PROGRESS","FINDING_STATUS_RESOLVED","FINDING_STATUS_REJECTED"],"type":"string","uniqueKey":"result.status","typeLabel":"enum\u003cstring>"},"status_detail":{"default":"FINDING_STATUS_DETAIL_UNSPECIFIED","description":"- FINDING_STATUS_DETAIL_MIXED_ASSESSMENTS: Deprecated: no longer emitted. Disagreeing assessments resolve through the fail-safe\nranking and surface as has_conflicting_assessments instead. Kept for client compatibility.","enum":["FINDING_STATUS_DETAIL_UNSPECIFIED","FINDING_STATUS_DETAIL_NEW","FINDING_STATUS_DETAIL_TRIAGED","FINDING_STATUS_DETAIL_REOPENED","FINDING_STATUS_DETAIL_INVESTIGATING","FINDING_STATUS_DETAIL_REMEDIATING","FINDING_STATUS_DETAIL_AWAITING_VERIFICATION","FINDING_STATUS_DETAIL_MIXED_ASSESSMENTS"],"title":"FindingStatusDetail provides additional context about the finding status","type":"string","uniqueKey":"result.status_detail","typeLabel":"enum\u003cstring>"},"resolution_reason":{"default":"FINDING_RESOLUTION_REASON_UNSPECIFIED","enum":["FINDING_RESOLUTION_REASON_UNSPECIFIED","FINDING_RESOLUTION_REASON_FIXED","FINDING_RESOLUTION_REASON_OBJECT_DELETED","FINDING_RESOLUTION_REASON_MITIGATED","FINDING_RESOLUTION_REASON_FALSE_POSITIVE","FINDING_RESOLUTION_REASON_NOT_AFFECTED","FINDING_RESOLUTION_REASON_RISK_ACCEPTED","FINDING_RESOLUTION_REASON_WONT_FIX","FINDING_RESOLUTION_REASON_DUPLICATE","FINDING_RESOLUTION_REASON_OUT_OF_SCOPE"],"title":"FindingResolutionReason represents the reason a finding was resolved or rejected","type":"string","uniqueKey":"result.resolution_reason","typeLabel":"enum\u003cstring>"},"is_in_kev":{"description":"Whether this CVE is in the CISA Known Exploited Vulnerabilities catalog","title":"Whether the CVE is in the CISA KEV catalog (from linked vulnerability)","type":"boolean","uniqueKey":"result.is_in_kev","typeLabel":"boolean"},"source":{"description":"Source tool or database","title":"Source tool or database","type":"string","uniqueKey":"result.source","typeLabel":"string"},"source_format":{"description":"Format of the evidence that produced the finding","title":"Source format (e.g. CYCLONEDX_JSON, SARIF)","type":"string","uniqueKey":"result.source_format","typeLabel":"string"},"recommendation":{"description":"Remediation recommendation for the finding","title":"Remediation recommendation for the finding","type":"string","uniqueKey":"result.recommendation","typeLabel":"string"},"location":{"description":"Where the finding was detected (e.g. file path, image layer)","title":"Location where the finding was detected","type":"string","uniqueKey":"result.location","typeLabel":"string"},"details":{"description":"Additional format-specific data","properties":{},"title":"Additional format-specific data","type":"object","uniqueKey":"result.details","typeLabel":"Additional format-specific data · object"},"component_id":{"description":"Associated software component ID","title":"Associated software component ID","type":"string","uniqueKey":"result.component_id","typeLabel":"string"},"first_seen_in_id":{"description":"Deprecated. Use reports for the complete source-report collection.","type":"string","uniqueKey":"result.first_seen_in_id","typeLabel":"string"},"last_seen_in_id":{"description":"Deprecated. Use reports for the complete source-report collection.","type":"string","uniqueKey":"result.last_seen_in_id","typeLabel":"string"},"fixed_in_id":{"description":"Deprecated. Use reports.fixed to identify the report that confirmed the fix.","type":"string","uniqueKey":"result.fixed_in_id","typeLabel":"string"},"created_at":{"description":"Timestamp when the finding was created","format":"date-time","title":"Timestamp when first created","type":"string","uniqueKey":"result.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"description":"Timestamp when the finding was last updated","format":"date-time","title":"Timestamp when last updated","type":"string","uniqueKey":"result.updated_at","typeLabel":"string\u003cdate-time>"},"status_changed_at":{"description":"Timestamp of the last status change","format":"date-time","title":"Timestamp when status last changed","type":"string","uniqueKey":"result.status_changed_at","typeLabel":"string\u003cdate-time>"},"resolved_at":{"description":"Timestamp when the finding was resolved","format":"date-time","title":"Timestamp when resolved","type":"string","uniqueKey":"result.resolved_at","typeLabel":"string\u003cdate-time>"},"project_name":{"description":"Name of the project","title":"Name of the project","type":"string","uniqueKey":"result.project_name","typeLabel":"string"},"project_version_name":{"description":"Name of the project version","title":"Name of the project version","type":"string","uniqueKey":"result.project_version_name","typeLabel":"string"},"artifact_ids":{"description":"IDs of artifacts affected by this finding","items":{"type":"string","uniqueKey":"result.artifact_ids.items.[INDEX]","typeLabel":"string"},"title":"IDs of artifacts affected by this finding","type":"array","uniqueKey":"result.artifact_ids","typeLabel":"string[]"},"first_seen_at":{"description":"Deprecated finding-processing timestamp. Use reports.evidence.created_at for report creation times.","format":"date-time","type":"string","uniqueKey":"result.first_seen_at","typeLabel":"string\u003cdate-time>"},"last_seen_at":{"description":"Deprecated finding-processing timestamp. Use reports.evidence.created_at for report creation times.","format":"date-time","type":"string","uniqueKey":"result.last_seen_at","typeLabel":"string\u003cdate-time>"},"vulnerability":{"description":"Metadata about a known vulnerability","example":{"is_in_kev":true,"description":"description","external_id":"external_id","id":"id","cwes":["cwes","cwes"],"cvss_vectors":["cvss_vectors","cvss_vectors"]},"properties":{"id":{"description":"Unique identifier of the vulnerability record","title":"Unique identifier of the vulnerability record","type":"string","uniqueKey":"result.vulnerability.id","typeLabel":"string"},"external_id":{"description":"CVE or advisory identifier","title":"External identifier (e.g. CVE-2024-1234)","type":"string","uniqueKey":"result.vulnerability.external_id","typeLabel":"string"},"description":{"description":"Human-readable description of the vulnerability","title":"Human-readable description","type":"string","uniqueKey":"result.vulnerability.description","typeLabel":"string"},"cwes":{"description":"CWE identifiers (e.g. CWE-79)","items":{"type":"string","uniqueKey":"result.vulnerability.cwes.items.[INDEX]","typeLabel":"string"},"title":"CWE identifiers","type":"array","uniqueKey":"result.vulnerability.cwes","typeLabel":"string[]"},"cvss_vectors":{"description":"CVSS vector strings (e.g. CVSS:3.1/AV:N/AC:L/...)","items":{"type":"string","uniqueKey":"result.vulnerability.cvss_vectors.items.[INDEX]","typeLabel":"string"},"title":"CVSS vector strings","type":"array","uniqueKey":"result.vulnerability.cvss_vectors","typeLabel":"string[]"},"is_in_kev":{"description":"Whether this CVE is in the CISA Known Exploited Vulnerabilities catalog","title":"Whether this CVE is in the CISA KEV catalog","type":"boolean","uniqueKey":"result.vulnerability.is_in_kev","typeLabel":"boolean"}},"title":"VulnerabilityInfo","type":"object","uniqueKey":"result.vulnerability","typeLabel":"VulnerabilityInfo · object"},"fixed_version":{"description":"Version that fixes the vulnerability","title":"Version that fixes the vulnerability","type":"string","uniqueKey":"result.fixed_version","typeLabel":"string"},"assessment_ids":{"description":"IDs of assessments linked to this finding","items":{"type":"string","uniqueKey":"result.assessment_ids.items.[INDEX]","typeLabel":"string"},"title":"IDs of assessments linked to this finding","type":"array","uniqueKey":"result.assessment_ids","typeLabel":"string[]"},"effective_assessment_status":{"default":"ASSESSMENT_STATUS_UNSPECIFIED","enum":["ASSESSMENT_STATUS_UNSPECIFIED","ASSESSMENT_STATUS_NOT_AFFECTED","ASSESSMENT_STATUS_AFFECTED","ASSESSMENT_STATUS_UNDER_INVESTIGATION","ASSESSMENT_STATUS_FIXED"],"title":"AssessmentStatus represents the OpenVEX-aligned status","type":"string","uniqueKey":"result.effective_assessment_status","typeLabel":"enum\u003cstring>"},"effective_assessment_id":{"description":"ID of the assessment that sets the finding status","title":"Assessment whose status the finding carries","type":"string","uniqueKey":"result.effective_assessment_id","typeLabel":"string"},"has_conflicting_assessments":{"description":"Whether active assessments disagree on the finding","title":"True when an active verdict ranks below the effective assessment and disagrees with it","type":"boolean","uniqueKey":"result.has_conflicting_assessments","typeLabel":"boolean"},"needs_review":{"description":"Whether an active assessment has a revision awaiting approval","title":"True when an active linked assessment has a revision awaiting approval","type":"boolean","uniqueKey":"result.needs_review","typeLabel":"boolean"},"reports":{"description":"Complete linked-report collection, including the recorded fix report. Ordered by evidence creation time and UUID, both descending. No pagination or truncation.","items":{"description":"FindingReport describes a source report and its recorded role for this finding.","example":{"evidence":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"fixed":true},"properties":{"evidence":{"description":"It represents an item in the list of evidence","example":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"properties":{"id":{"description":"Unique identifier of the evidence","title":"ID is the unique identifier of the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.id","typeLabel":"string"},"name":{"description":"Name of the evidence","title":"Name is the name of the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.name","typeLabel":"string"},"digest":{"description":"Cryptographic digest of the evidence content","title":"Digest is the digest of the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.digest","typeLabel":"string"},"kind":{"description":"Type of evidence (e.g., SBOM, attestation, vulnerability report)","title":"Kind is the type of evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.kind","typeLabel":"string"},"subject_name":{"description":"Name of the subject related to the evidence eg: name of the artifact, container image etc","title":"The name of the subject related to the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.subject_name","typeLabel":"string"},"subject_version":{"description":"Version of the subject related to the evidence","title":"The version of the subject related to the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.subject_version","typeLabel":"string"},"annotations":{"additionalProperties":{"type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.annotations.additionalProperties","typeLabel":"string"},"description":"Custom key-value pairs associated with the evidence","title":"Annotations are key-value pairs associated with the evidence","type":"object","uniqueKey":"result.reports.items.[INDEX].evidence.annotations","typeLabel":"Annotations are key-value pairs associated with the evidence · object"},"organization_id":{"description":"ID of the organization that owns the evidence","title":"OrganizationID is the ID of the organization that owns the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.organization_id","typeLabel":"string"},"organization_name":{"description":"Name of the organization that owns the evidence","title":"OrganizationName is the name of the organization that owns the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.organization_name","typeLabel":"string"},"workflow_id":{"description":"ID of the workflow that created the evidence","title":"WorkflowID is the ID of the workflow that created the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.workflow_id","typeLabel":"string"},"workflow_name":{"description":"Name of the workflow that created the evidence","title":"WorkflowName is the name of the workflow that created the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.workflow_name","typeLabel":"string"},"workflow_run_id":{"description":"ID of the workflow run that created the evidence","title":"WorkflowRunID is the ID of the workflow run that created the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.workflow_run_id","typeLabel":"string"},"project_id":{"description":"ID of the project that owns the evidence","title":"ProjectID is the ID of the project that owns the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.project_id","typeLabel":"string"},"project_name":{"description":"Name of the project that owns the evidence","title":"ProjectName is the name of the project that owns the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.project_name","typeLabel":"string"},"project_version_id":{"description":"ID of the project version that owns the evidence","title":"ProjectVersionID is the ID of the project version that owns the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.project_version_id","typeLabel":"string"},"project_version_name":{"description":"Name of the project version that owns the evidence","title":"ProjectVersionName is the name of the project version that owns the evidence","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.project_version_name","typeLabel":"string"},"created_at":{"description":"Timestamp when the evidence was created","format":"date-time","title":"CreatedAt is the timestamp when the evidence was created","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.created_at","typeLabel":"string\u003cdate-time>"},"latest_in_project":{"description":"Indicates whether this evidence is the most recent of its kind and name within the project","title":"LatestInProject indicates whether this evidence is the most recent of its kind and name within the project","type":"boolean","uniqueKey":"result.reports.items.[INDEX].evidence.latest_in_project","typeLabel":"boolean"},"latest_in_project_version":{"description":"Indicates whether this evidence is the most recent of its kind and name within the project version","title":"LatestInProjectVersion indicates whether this evidence is the most recent of its kind and name within the project version","type":"boolean","uniqueKey":"result.reports.items.[INDEX].evidence.latest_in_project_version","typeLabel":"boolean"},"uploaded_to_cas":{"description":"Indicates whether the evidence has been uploaded to the content addressable storage","title":"UploadedToCas indicates whether the evidence has been uploaded to the content addressable storage","type":"boolean","uniqueKey":"result.reports.items.[INDEX].evidence.uploaded_to_cas","typeLabel":"boolean"},"ingestion_started_at":{"description":"Timestamp when SBOM ingestion processing started (only for SBOM evidence types)","format":"date-time","title":"IngestionStartedAt is the timestamp when SBOM ingestion processing started","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.ingestion_started_at","typeLabel":"string\u003cdate-time>"},"ingestion_finished_at":{"description":"Timestamp when SBOM ingestion processing finished (only for SBOM evidence types)","format":"date-time","title":"IngestionFinishedAt is the timestamp when SBOM ingestion processing finished","type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.ingestion_finished_at","typeLabel":"string\u003cdate-time>"},"ingestion_has_error":{"description":"Indicates whether SBOM ingestion failed (only for SBOM evidence types)","title":"IngestionHasError indicates whether SBOM ingestion failed","type":"boolean","uniqueKey":"result.reports.items.[INDEX].evidence.ingestion_has_error","typeLabel":"boolean"},"policy_status_summary":{"description":"RunPolicyStatusSummary bundles the canonical RunPolicyStatus with per-evaluation\ncounters for a workflow run. Mirrors controlplane.v1.PolicyStatusSummary.","example":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"properties":{"status":{"default":"RUN_POLICY_STATUS_UNSPECIFIED","description":"RunPolicyStatus is the canonical, categorical policy outcome for a workflow run.\nNamed \"Run\" to distinguish from the per-policy PolicyStatus message in policies.proto.","enum":["RUN_POLICY_STATUS_UNSPECIFIED","RUN_POLICY_STATUS_NOT_APPLICABLE","RUN_POLICY_STATUS_PASSED","RUN_POLICY_STATUS_SKIPPED","RUN_POLICY_STATUS_WARNING","RUN_POLICY_STATUS_BLOCKED","RUN_POLICY_STATUS_BYPASSED"],"type":"string","uniqueKey":"result.reports.items.[INDEX].evidence.policy_status_summary.status","typeLabel":"enum\u003cstring>"},"total":{"description":"Total number of policy evaluations that ran","format":"int32","title":"Total number of policy evaluations","type":"integer","uniqueKey":"result.reports.items.[INDEX].evidence.policy_status_summary.total","typeLabel":"integer\u003cint32>"},"passed":{"description":"Number of evaluations with no violations and not skipped","format":"int32","title":"Number of evaluations that passed","type":"integer","uniqueKey":"result.reports.items.[INDEX].evidence.policy_status_summary.passed","typeLabel":"integer\u003cint32>"},"skipped":{"description":"Number of evaluations that were skipped","format":"int32","title":"Number of evaluations that were skipped","type":"integer","uniqueKey":"result.reports.items.[INDEX].evidence.policy_status_summary.skipped","typeLabel":"integer\u003cint32>"},"violated":{"description":"Total number of violations across all evaluations","format":"int32","title":"Total number of violations across all evaluations","type":"integer","uniqueKey":"result.reports.items.[INDEX].evidence.policy_status_summary.violated","typeLabel":"integer\u003cint32>"},"has_gates":{"description":"Whether any policies had gates in effect (gate:true or ENFORCED strategy)","title":"Whether any policies had gates in effect","type":"boolean","uniqueKey":"result.reports.items.[INDEX].evidence.policy_status_summary.has_gates","typeLabel":"boolean"}},"type":"object","uniqueKey":"result.reports.items.[INDEX].evidence.policy_status_summary","typeLabel":"object"},"policies_passed":{"description":"Number of policy evaluations that passed (convenience for x/N display)","format":"int32","title":"PoliciesPassed is the number of policy evaluations that passed","type":"integer","uniqueKey":"result.reports.items.[INDEX].evidence.policies_passed","typeLabel":"integer\u003cint32>"},"policies_total":{"description":"Total number of policy evaluations (convenience for x/N display)","format":"int32","title":"PoliciesTotal is the total number of policy evaluations","type":"integer","uniqueKey":"result.reports.items.[INDEX].evidence.policies_total","typeLabel":"integer\u003cint32>"}},"title":"EvidenceListItem","type":"object","uniqueKey":"result.reports.items.[INDEX].evidence","typeLabel":"EvidenceListItem · object"},"fixed":{"description":"True when this report is the recorded fix report. This does not infer a fix from report order or the finding's current status.","type":"boolean","uniqueKey":"result.reports.items.[INDEX].fixed","typeLabel":"boolean"}},"type":"object","uniqueKey":"result.reports.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"result.reports","typeLabel":"object[]"}},"title":"FindingDetail","type":"object","uniqueKey":"result","typeLabel":"FindingDetail · object"}},"title":"FindingServiceDescribeResponse","type":"object","uniqueKey":"","typeLabel":"FindingServiceDescribeResponse · object"},"examples":{"Example":{"title":"Example","value":{"result":{"reports":[{"evidence":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"fixed":true},{"evidence":{"workflow_id":"workflow_id","workflow_name":"workflow_name","uploaded_to_cas":true,"subject_version":"subject_version","annotations":{"key":"annotations"},"created_at":"2000-01-23T04:56:07.000Z","project_name":"project_name","latest_in_project":true,"policies_total":2,"project_version_name":"project_version_name","project_id":"project_id","ingestion_finished_at":"2000-01-23T04:56:07.000Z","digest":"digest","id":"id","workflow_run_id":"workflow_run_id","policies_passed":5,"kind":"kind","latest_in_project_version":true,"ingestion_started_at":"2000-01-23T04:56:07.000Z","organization_name":"organization_name","project_version_id":"project_version_id","ingestion_has_error":true,"policy_status_summary":{"violated":5,"total":0,"has_gates":true,"passed":6,"status":"RUN_POLICY_STATUS_UNSPECIFIED","skipped":1},"organization_id":"organization_id","name":"name","subject_name":"subject_name"},"fixed":true}],"package_purl":"package_purl","fixed_in_id":"fixed_in_id","status_changed_at":"2000-01-23T04:56:07.000Z","recommendation":"recommendation","created_at":"2000-01-23T04:56:07.000Z","external_id":"external_id","source":"source","project_name":"project_name","needs_review":true,"first_seen_in_id":"first_seen_in_id","project_version_name":"project_version_name","updated_at":"2000-01-23T04:56:07.000Z","last_seen_in_id":"last_seen_in_id","assessment_ids":["assessment_ids","assessment_ids"],"details":"{}","id":"id","severity":"FINDING_SEVERITY_UNSPECIFIED","source_format":"source_format","component_id":"component_id","is_in_kev":true,"first_seen_at":"2000-01-23T04:56:07.000Z","vulnerability":{"is_in_kev":true,"description":"description","external_id":"external_id","id":"id","cwes":["cwes","cwes"],"cvss_vectors":["cvss_vectors","cvss_vectors"]},"finding_type":"FINDING_TYPE_UNSPECIFIED","has_conflicting_assessments":true,"status_detail":"FINDING_STATUS_DETAIL_UNSPECIFIED","resolution_reason":"FINDING_RESOLUTION_REASON_UNSPECIFIED","fixed_version":"fixed_version","resolved_at":"2000-01-23T04:56:07.000Z","artifact_ids":["artifact_ids","artifact_ids"],"location":"location","effective_assessment_status":"ASSESSMENT_STATUS_UNSPECIFIED","last_seen_at":"2000-01-23T04:56:07.000Z","effective_assessment_id":"effective_assessment_id","status":"FINDING_STATUS_UNSPECIFIED"}}}},"exampleType":"generated"}},"description":"A successful response.","exampleType":"generated"},"603d47c8-b123-4adb-a573-16b9015a5381":{"content":{"application/json":{"schema":{"description":"Response for bad request","example":{"code":0,"details":["details","details"],"message":"message"},"properties":{"code":{"default":3,"description":"The error code indicating the type of error. It's fixed to 3, which is the code for INVALID_ARGUMENT.","format":"int32","type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer\u003cint32>"},"message":{"description":"A human-readable message providing more details about the error.","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional details about the error.","items":{"type":"string","uniqueKey":"details.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"details","typeLabel":"string[]"}},"required":["code","message"],"title":"BadRequestResponse","type":"object","uniqueKey":"","typeLabel":"BadRequestResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":0,"details":["details","details"],"message":"message"}}},"exampleType":"generated"}},"description":"Bad Request - The request was invalid or cannot be served.","exampleType":"generated"},"307429d5-6ecc-49c8-9be2-b44f7404df83":{"content":{"application/json":{"schema":{"description":"Response for unauthorized access","example":{"code":6,"details":["details","details"],"message":"message"},"properties":{"code":{"default":16,"description":"The error code indicating the type of error. It's fixed to 16, which is the code for UNAUTHENTICATED.","format":"int32","type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer\u003cint32>"},"message":{"description":"A human-readable message providing more details about the error.","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional details about the error.","items":{"type":"string","uniqueKey":"details.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"details","typeLabel":"string[]"}},"required":["code","message"],"title":"UnauthorizedResponse","type":"object","uniqueKey":"","typeLabel":"UnauthorizedResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":6,"details":["details","details"],"message":"message"}}},"exampleType":"generated"}},"description":"Unauthorized - Authentication is required.","exampleType":"generated"},"1b62b415-b56c-4dbb-ab90-e8dba9c5c3a9":{"content":{"application/json":{"schema":{"description":"Response for permission denied","example":{"code":1,"details":["details","details"],"message":"message"},"properties":{"code":{"default":7,"description":"The error code indicating the type of error. It's fixed to 7, which is the code for PERMISSION_DENIED.","format":"int32","type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer\u003cint32>"},"message":{"description":"A human-readable message providing more details about the error.","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional details about the error.","items":{"type":"string","uniqueKey":"details.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"details","typeLabel":"string[]"}},"required":["code","message"],"title":"PermissionDeniedResponse","type":"object","uniqueKey":"","typeLabel":"PermissionDeniedResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":1,"details":["details","details"],"message":"message"}}},"exampleType":"generated"}},"description":"Forbidden - You do not have permission to access this resource.","exampleType":"generated"},"20b3334f-4a7f-49a0-9caa-ff486454f927":{"content":{"application/json":{"schema":{"description":"Response for internal server error","example":{"code":5,"details":["details","details"],"message":"message"},"properties":{"code":{"default":13,"description":"The error code indicating the type of error. It's fixed to 13, which is the code for INTERNAL_ERROR.","format":"int32","type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer\u003cint32>"},"message":{"description":"A human-readable message providing more details about the error.","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional details about the error.","items":{"type":"string","uniqueKey":"details.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"details","typeLabel":"string[]"}},"required":["code","message"],"title":"InternalServerErrorResponse","type":"object","uniqueKey":"","typeLabel":"InternalServerErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":5,"details":["details","details"],"message":"message"}}},"exampleType":"generated"}},"description":"Internal Server Error - An unexpected error occurred on the server.","exampleType":"generated"},"e86abaf3-f125-44a1-aa01-bcee620ed574":{"content":{"application/json":{"schema":{"example":{"code":5,"details":[{"@type":"@type"},{"@type":"@type"}],"message":"message"},"properties":{"code":{"format":"int32","type":"integer","uniqueKey":"code","typeLabel":"integer\u003cint32>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"details":{"items":{"additionalProperties":{"type":"object","uniqueKey":"details.items.[INDEX].additionalProperties","typeLabel":"object"},"example":{"@type":"@type"},"properties":{"@type":{"type":"string","uniqueKey":"details.items.[INDEX].@type","typeLabel":"string"}},"type":"object","uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":5,"details":[{"@type":"@type"},{"@type":"@type"}],"message":"message"}}},"exampleType":"generated"}},"description":"An unexpected error response.","exampleType":"generated"}},"security":{"ace5891d-f278-4089-9e45-73c99269d5ad":{"bearerToken":{"description":"Bearer token for authentication","type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerToken"}}},"servers":{"cffda803-c383-4264-b179-18063a2c0f46":{"url":"https://api.app.chainloop.dev/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Bearer token for authentication","type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token for authentication","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerToken","name":"Authorization"}],"title":"bearerToken"}]},"originalFileLocation":"https://api.app.chainloop.dev/openapi.yaml"},"subdomain":"chainloop","siteName":"Chainloop Documentation","title":"Describe a finding - Chainloop Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T13:40:14.064Z","originalFileLocation":"api-reference/findingservice/describe-a-finding.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get detailed information about a specific security finding.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chainloop 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/chainloop/mw3ai7qmEaYOPNu0/_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/chainloop/mw3ai7qmEaYOPNu0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chainloop/mw3ai7qmEaYOPNu0/_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/chainloop/mw3ai7qmEaYOPNu0/_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/chainloop/mw3ai7qmEaYOPNu0/_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/chainloop/mw3ai7qmEaYOPNu0/_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/chainloop/mw3ai7qmEaYOPNu0/_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/chainloop/mw3ai7qmEaYOPNu0/_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/chainloop/mw3ai7qmEaYOPNu0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Describe a finding - Chainloop Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get detailed information about a specific security finding.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chainloop Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chainloop.mintlify.site/_mintlify/api/og/v2?division=FindingService\u0026amp;title=Describe+a+finding\u0026amp;description=Get+detailed+information+about+a+specific+security+finding.\u0026amp;theme=61c93c80cca4eee0101862fb\u0026amp;signature=c50fb41b824c22dad37c2ffe81dff0af2a5e9d6157d9a9bf66ca5a5e5f6b1733\">\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=\"Describe a finding - Chainloop Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get detailed information about a specific security finding.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chainloop.mintlify.site/_mintlify/api/og/v2?division=FindingService\u0026amp;title=Describe+a+finding\u0026amp;description=Get+detailed+information+about+a+specific+security+finding.\u0026amp;theme=61c93c80cca4eee0101862fb\u0026amp;signature=c50fb41b824c22dad37c2ffe81dff0af2a5e9d6157d9a9bf66ca5a5e5f6b1733\">\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/chainloop/mw3ai7qmEaYOPNu0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chainloop Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2D1BD2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/findingservice/describe-a-finding.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.chainloop.dev/#organization\",\"name\":\"Chainloop Documentation\",\"url\":\"https://docs.chainloop.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chainloop/piBVJM34fSFTGk0R/images/logo/light.svg?fit=max\u0026auto=format\u0026n=piBVJM34fSFTGk0R\u0026q=85\u0026s=4bc355683f7e78c629ece2e28db71dff\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.chainloop.dev#website\",\"name\":\"Chainloop Documentation\",\"url\":\"https://docs.chainloop.dev\",\"publisher\":{\"@id\":\"https://docs.chainloop.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding#webpage\",\"url\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding\",\"name\":\"Describe a finding\",\"description\":\"Get detailed information about a specific security finding.\",\"dateModified\":\"2026-11-05T13:40:14.064Z\",\"isPartOf\":{\"@id\":\"https://docs.chainloop.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Platform Endpoints\",\"item\":\"https://docs.chainloop.dev/api-reference/agentsservice/evaluate-evidence-with-ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"FindingService\",\"item\":\"https://docs.chainloop.dev/api-reference/findingservice/list-findings\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Describe a finding\",\"item\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding#apireference\",\"headline\":\"Describe a finding\",\"name\":\"Describe a finding\",\"description\":\"Get detailed information about a specific security finding.\",\"url\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chainloop.dev/api-reference/findingservice/describe-a-finding#webpage\"},\"dateModified\":\"2026-11-05T13:40:14.064Z\",\"publisher\":{\"@id\":\"https://docs.chainloop.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.chainloop.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chainloop Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Chainloop Documentation","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://chainloop.dev/"},{"anchor":"Blog","icon":"newspaper","href":"https://chainloop.dev/blog"},{"anchor":"Get Help","icon":"headset","href":"https://help.chainloop.dev"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"Reference","menu":[{"item":"CLI Reference","icon":"terminal","pages":[{"title":"CLI Reference","href":"/cli/installation"}]},{"item":"API Reference","icon":"code","groups":[{"group":" ","pages":[{"title":"Overview","href":"/api-reference/overview"}]},{"group":"Chainloop Controlplane Endpoints","pages":[{"group":"ReferrerService","pages":[{"title":"Discover private referrer","deprecated":null,"version":null,"openapi":"https://cp.chainloop.dev/openapi.yaml get /discover/{digest}","href":"/api-reference/referrerservice/discover-private-referrer"}]},{"group":"DownloadService","pages":[{"title":"Download Artifacts from CAS","deprecated":null,"version":null,"openapi":"https://cp.chainloop.dev/openapi.yaml get /download/{digest}","href":"/api-reference/downloadservice/download-artifacts-from-cas"}]}]},{"group":"Platform Endpoints","pages":[{"group":"AgentsService","pages":[{"title":"Evaluate evidence with AI","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/agents/evaluate-evidence","href":"/api-reference/agentsservice/evaluate-evidence-with-ai"}]},{"group":"ArtifactService","pages":[{"title":"List artifacts","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/artifacts","href":"/api-reference/artifactservice/list-artifacts"},{"title":"Describe an artifact","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/artifacts/{id}","href":"/api-reference/artifactservice/describe-an-artifact"}]},{"group":"AssessmentService","pages":[{"title":"List assessments","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/assessments","href":"/api-reference/assessmentservice/list-assessments"},{"title":"Create an assessment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/assessments","href":"/api-reference/assessmentservice/create-an-assessment"},{"title":"Trigger auto-assessment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/assessments/auto","href":"/api-reference/assessmentservice/trigger-auto-assessment"},{"title":"List effective assessments for lookups","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/assessments/list-effective","href":"/api-reference/assessmentservice/list-effective-assessments-for-lookups"},{"title":"Approve an assessment revision","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/assessments/revisions/{revision_id}/approve","href":"/api-reference/assessmentservice/approve-an-assessment-revision"},{"title":"Reject an assessment revision","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/assessments/revisions/{revision_id}/reject","href":"/api-reference/assessmentservice/reject-an-assessment-revision"},{"title":"Get assessment summary","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/assessments/summary","href":"/api-reference/assessmentservice/get-assessment-summary"},{"title":"List assessment revisions","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/assessments/{assessment_id}/revisions","href":"/api-reference/assessmentservice/list-assessment-revisions"},{"title":"Get an assessment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/assessments/{id}","href":"/api-reference/assessmentservice/get-an-assessment"},{"title":"Update an assessment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml put /v1/assessments/{id}","href":"/api-reference/assessmentservice/update-an-assessment"},{"title":"Delete an assessment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml delete /v1/assessments/{id}","href":"/api-reference/assessmentservice/delete-an-assessment"}]},{"group":"AttestationsService","pages":[{"title":"Creates and attestation from a piece of content","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/attestations","href":"/api-reference/attestationsservice/creates-and-attestation-from-a-piece-of-content"}]},{"group":"ComplianceService","pages":[{"title":"List a policy evaluation's violations","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/compliance/policy-evaluations/{policy_evaluation_id}/violations","href":"/api-reference/complianceservice/list-a-policy-evaluations-violations"},{"title":"Get product-level compliance aggregation","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/compliance/product","href":"/api-reference/complianceservice/get-product-level-compliance-aggregation"},{"title":"Get single-requirement product compliance detail","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/compliance/product/requirement","href":"/api-reference/complianceservice/get-single-requirement-product-compliance-detail"},{"title":"Get lightweight product compliance summary","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/compliance/product/summary","href":"/api-reference/complianceservice/get-lightweight-product-compliance-summary"},{"title":"Get project-level compliance evaluation","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/compliance/project","href":"/api-reference/complianceservice/get-project-level-compliance-evaluation"}]},{"group":"ComponentService","pages":[{"title":"List software components","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/components","href":"/api-reference/componentservice/list-software-components"},{"title":"Summarize components","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/components/summary","href":"/api-reference/componentservice/summarize-components"},{"title":"Describe a component","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/components/{id}","href":"/api-reference/componentservice/describe-a-component"}]},{"group":"EnvironmentsService","pages":[{"title":"List deployment names","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/deployment-names","href":"/api-reference/environmentsservice/list-deployment-names"},{"title":"List deployment records","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/deployments","href":"/api-reference/environmentsservice/list-deployment-records"},{"title":"Record a deployment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/deployments","href":"/api-reference/environmentsservice/record-a-deployment"},{"title":"List environments","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/environments","href":"/api-reference/environmentsservice/list-environments"},{"title":"Create an environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/environments","href":"/api-reference/environmentsservice/create-an-environment"},{"title":"Describe an environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/environments/{id}","href":"/api-reference/environmentsservice/describe-an-environment"},{"title":"Update an environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml put /v1/environments/{id}","href":"/api-reference/environmentsservice/update-an-environment"},{"title":"Delete an environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml delete /v1/environments/{id}","href":"/api-reference/environmentsservice/delete-an-environment"}]},{"group":"EvidenceService","pages":[{"title":"List pieces of evidence","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/evidence","href":"/api-reference/evidenceservice/list-pieces-of-evidence"},{"title":"Describe a piece of evidence","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/evidence/{id}","href":"/api-reference/evidenceservice/describe-a-piece-of-evidence"}]},{"group":"FindingService","pages":[{"title":"List findings","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/findings","href":"/api-reference/findingservice/list-findings"},{"title":"Trigger auto-remediation","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/findings/auto-remediation","href":"/api-reference/findingservice/trigger-auto-remediation"},{"title":"Ingest SBOM findings","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/findings/ingest-sbom","href":"/api-reference/findingservice/ingest-sbom-findings"},{"title":"Summarize findings","description":"Return aggregate finding counts (totals, assessment breakdown, unassessed severity × fixable matrix, suggested-action scalars) for the current organization, with optional filters.","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/findings/summary","href":"/api-reference/findingservice/summarize-findings"},{"title":"Describe a finding","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/findings/{finding_id}","href":"/api-reference/findingservice/describe-a-finding"},{"title":"Update a finding","description":"Transition a finding's lifecycle status. resolution_reason is only accepted when the new status is resolved or rejected and is cleared otherwise.","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml put /v1/findings/{finding_id}","href":"/api-reference/findingservice/update-a-finding"},{"title":"Delete a finding","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml delete /v1/findings/{finding_id}","href":"/api-reference/findingservice/delete-a-finding"}]},{"group":"PolicyService","pages":[{"title":"Get a policy group by name","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/groups/{group_name}","href":"/api-reference/policyservice/get-a-policy-group-by-name"},{"title":"Update an existing policy","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml put /v1/policies","href":"/api-reference/policyservice/update-an-existing-policy"},{"title":"Create a new policy","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/policies","href":"/api-reference/policyservice/create-a-new-policy"},{"title":"Validate a policy attachment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/policies/validate","href":"/api-reference/policyservice/validate-a-policy-attachment"},{"title":"Get a policy by name","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/policies/{policy_name}","href":"/api-reference/policyservice/get-a-policy-by-name"},{"title":"Remove a policy from the list","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml delete /v1/policies/{policy_name}","href":"/api-reference/policyservice/remove-a-policy-from-the-list"}]},{"group":"LogicalEnvironmentsService","pages":[{"title":"List logical environments","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/logical-environments","href":"/api-reference/logicalenvironmentsservice/list-logical-environments"},{"title":"Create a logical environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/logical-environments","href":"/api-reference/logicalenvironmentsservice/create-a-logical-environment"},{"title":"Describe a logical environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/logical-environments/{id}","href":"/api-reference/logicalenvironmentsservice/describe-a-logical-environment"},{"title":"Update a logical environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml put /v1/logical-environments/{id}","href":"/api-reference/logicalenvironmentsservice/update-a-logical-environment"},{"title":"Delete a logical environment","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml delete /v1/logical-environments/{id}","href":"/api-reference/logicalenvironmentsservice/delete-a-logical-environment"}]},{"group":"AsyncOperationsService","pages":[{"title":"List async operations","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/operations","href":"/api-reference/asyncoperationsservice/list-async-operations"},{"title":"Dispatch a managed workflow scan","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml post /v1/operations/dispatch-workflow-scan","href":"/api-reference/asyncoperationsservice/dispatch-a-managed-workflow-scan"},{"title":"Get async operation status","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/operations/{operation_id}","href":"/api-reference/asyncoperationsservice/get-async-operation-status"}]},{"group":"ProductsService","pages":[{"title":"List products","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/products","href":"/api-reference/productsservice/list-products"},{"title":"Get product version details","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/products/{product_id}/versions/{version_id}","href":"/api-reference/productsservice/get-product-version-details"}]},{"group":"ProjectsService","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/projects","href":"/api-reference/projectsservice/list-projects"}]},{"group":"UserService","pages":[{"title":"Get current user information","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/users/info","href":"/api-reference/userservice/get-current-user-information"}]},{"group":"WorkflowTemplateService","pages":[{"title":"List workflow templates","deprecated":null,"version":null,"openapi":"https://api.app.chainloop.dev/openapi.yaml get /v1/workflow-templates","href":"/api-reference/workflowtemplateservice/list-workflow-templates"}]}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Describe a finding - Chainloop Documentation","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}