Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches.
Use this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package.
Selector catalogue
Use the following selectors with the fields query parameter to choose which fields the response includes. See Choose what the response includes for details.
Selector
Data
Default
files
Identity/status fields and content safety; inventory only
No
files.stats
Adds nullable additions/deletions; implies files and requests stats
No
files.patch
Adds nullable patch and omission reason; implies stats and requests patches
Yes
Failures use a stable problem document. When supplied by the source, optional recovery hints identify the failed side, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 UNSUPPORTED_REGISTRY; legally blocked repositories return 451 REPOSITORY_LEGALLY_BLOCKED. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response.
For upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.
Optional caller-defined session ID: one to 64 ASCII letters, digits, underscores or hyphens, preserved exactly. Supply the header at most once. Invalid supplied IDs return 400 INVALID_SESSION_ID; no session is created.
Finite comma-separated selectors: files, files.stats, and files.patch. The default is files.patch. Dependencies are additive; repeated selector tokens are idempotent. Unknown, empty, leaf, and wildcard selectors, plus repeated fields query parameters, are rejected.
Use the case-sensitive selectors in the catalogue. Order and duplicate selectors do not affect the result. ASCII whitespace around selectors is ignored. The decoded value is limited to 2048 UTF-8 bytes. Empty or unknown selectors and repeated fields query parameters return 400 VALIDATION_ERROR. A group does not include nested groups unless the catalogue says so; only listed wildcard bundles are supported.
Maximum string length: 2048
Body
application/json
Compare two package versions or two repository refs.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"GitHits","colors":{"primary":"#cc3f8b","light":"#ff72be","dark":"#cc3f8b"},"logo":{"light":"https://mintcdn.com/githits/nEuGn8_ZROo1DncD/images/githits-wordmark.svg?fit=max\u0026auto=format\u0026n=nEuGn8_ZROo1DncD\u0026q=85\u0026s=33b1a4083b1476ad8520731d35d55987","dark":"https://mintcdn.com/githits/nEuGn8_ZROo1DncD/images/githits-wordmark.svg?fit=max\u0026auto=format\u0026n=nEuGn8_ZROo1DncD\u0026q=85\u0026s=33b1a4083b1476ad8520731d35d55987","href":"/"},"favicon":"https://mintcdn.com/githits/Hm40jjPoMZp3cAjh/images/githits-favicon.svg?fit=max\u0026auto=format\u0026n=Hm40jjPoMZp3cAjh\u0026q=85\u0026s=701b144dbf93beea1351b26de5f854f1","api":{"playground":{"proxy":false,"credentials":false}},"appearance":{"default":"dark"},"background":{"color":{"light":"#ffffff","dark":"#13161a"}},"navbar":{"primary":{"type":"github","href":"https://github.com/githits-com/githits-cli"}},"fonts":{"heading":{"family":"Lexend","weight":600},"body":{"family":"Onest"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"githits","hasAudioNarration":false,"actualSubdomain":"githits","customDomains":["docs.githits.com"],"gitSource":{"type":"github","owner":"githits-com","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af1cc5c9e9a7e27ab8b73c3","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API","count":35},{"language":"default","tag":"Documentation","count":28},{"language":"default","tag":"v1 reference","count":28},{"language":"default","tag":"Experimental","count":13},{"language":"default","tag":"Agent tools","count":8},{"language":"default","tag":"Get started","count":7},{"language":"default","tag":"Get Started","count":6},{"language":"default","tag":"Scan","count":6},{"language":"default","tag":"Packages","count":5},{"language":"default","tag":"CLI","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--githits-primary-200: #ffb8de;--githits-primary-400: #ff72be;--githits-primary-500: #ff4fae;--githits-primary-700: #992f68;--githits-primary-800: #651f45;--githits-neutral-primary: #ffffff;--githits-neutral-secondary: #d5d9df;--githits-neutral-muted: #abb2bf;--githits-neutral-border: #4a4e56;--githits-neutral-background: #21262d;--githits-neutral-surface: #13161a;--githits-text: var(--githits-neutral-border);--githits-heading: var(--githits-neutral-surface);--githits-accent: var(--githits-primary-700);--githits-surface: var(--githits-neutral-primary);--githits-border: var(--githits-neutral-muted);--githits-code-surface: var(--githits-neutral-secondary);--githits-code-text: var(--githits-primary-800);--githits-duration-normal: 200ms;--githits-ease-in-out: cubic-bezier(0.4, 0, 0.2, 1)}html.dark{--githits-text: var(--githits-neutral-secondary);--githits-heading: var(--githits-neutral-primary);--githits-accent: var(--githits-primary-400);--githits-surface: var(--githits-neutral-background);--githits-border: var(--githits-neutral-border);--githits-code-surface: var(--githits-neutral-background);--githits-code-text: var(--githits-primary-200)}html{letter-spacing:0}code,pre{font-family:Consolas, \"SF Mono\", Menlo, Monaco, monospace}#content :not(pre)>code{background:var(--githits-code-surface);color:var(--githits-code-text)}#navbar{border-bottom-color:color-mix(in srgb, var(--githits-primary-500) 18%, transparent)}#navbar a[href=\"/\"]:has(img[src*=\"githits-wordmark\"]){box-sizing:border-box;display:inline-flex;flex:0 0 9.5rem;width:9.5rem;min-width:9.5rem;align-items:center;gap:0.5rem}#navbar a[href=\"/\"]:has(img[src*=\"githits-wordmark\"])::after{content:\"Beta\";display:inline-flex;align-items:center;justify-content:center;min-height:1.5rem;padding:0.25rem 0.5rem;border:1px solid var(--githits-accent);border-radius:0.25rem;color:var(--githits-accent);font-family:inherit;font-size:0.625rem;font-weight:600;line-height:1rem;text-transform:uppercase;white-space:nowrap}#navbar a[href=\"/\"] img[src*=\"githits-wordmark\"]{width:6.5rem;height:1.516rem;aspect-ratio:554 / 129.3;object-fit:contain;vertical-align:middle}@container navbar (max-width: 48rem){#navbar nav[aria-label=\"Main\"]{flex-shrink:0}#navbar nav[aria-label=\"Main\"] a{padding-inline:0.25rem}}.githits-beta-note{display:inline-flex;align-items:center;max-width:100%;margin:0.75rem 0 1.5rem;padding:0.5rem 0.75rem;border:1px solid color-mix(in srgb, var(--githits-accent) 34%, transparent);border-radius:8px;background:color-mix(in srgb, var(--githits-accent) 9%, transparent);color:var(--githits-heading);font-size:0.875rem;font-weight:500;line-height:1.5}.githits-command-toolbar{display:flex;justify-content:flex-end;margin:1.5rem 0 -0.25rem}.githits-command-toggle{display:inline-flex;align-items:center;gap:0.625rem;min-height:2.5rem;padding:0.5rem 0.875rem;border:1px solid var(--githits-border);border-radius:8px;background:var(--githits-surface);color:var(--githits-heading);font-size:0.875rem;font-weight:600;line-height:1;cursor:pointer}.githits-command-toggle::after{content:\"\";width:0.5rem;height:0.5rem;border-right:2px solid currentColor;border-bottom:2px solid currentColor;transform:rotate(45deg);transition:transform var(--githits-duration-normal) var(--githits-ease-in-out)}.githits-command-toggle[aria-expanded=\"true\"]::after{transform:rotate(225deg)}.githits-command-toggle:hover{border-color:var(--githits-accent);color:var(--githits-accent)}.githits-command-toggle:focus-visible,.githits-feature-card:focus-visible{outline:2px solid var(--githits-accent);outline-offset:3px}html[data-current-path=\"/cli/commands\"] #content [data-component-part=\"accordion-title-container\"]{display:flex;flex-direction:column;gap:0.25rem;line-height:1.35}html[data-current-path=\"/cli/commands\"] #content [data-component-part=\"accordion-description\"]{color:var(--githits-text);line-height:1.45}.githits-feature-grid{margin-top:1.25rem}.githits-tool-columns{display:grid;grid-template-columns:repeat(auto-fit, minmax(min(100%, 12.5rem), 1fr));gap:1rem}.githits-feature-grid .githits-feature-card{background:transparent;border:1px solid transparent;box-shadow:none;color:var(--githits-heading)}.githits-feature-grid .githits-feature-card:hover{border-color:var(--githits-accent)}.githits-feature-card::before{content:\"\";display:block;aspect-ratio:16 / 9;box-sizing:border-box;background-color:var(--githits-neutral-surface);background-image:var(--githits-illustration);background-size:contain;background-position:center;background-repeat:no-repeat;border:0;border-radius:8px}.githits-feature-code{--githits-illustration: url(\"/images/githits-code-context.svg\")}.githits-feature-docs{--githits-illustration: url(\"/images/githits-open-source-refresh.svg\")}.githits-feature-packages{--githits-illustration: url(\"/images/githits-reasoning-rank.svg\")}.githits-feature-card [data-component-part=\"card-content\"]{color:var(--githits-text)}@media (prefers-reduced-motion: reduce){.githits-command-toggle::after{transition:none}}"}],"page":{"pagePath":"api-reference/v1/code-diff/compare-two-exact-source-trees","slug":"/api-reference/v1/code-diff/compare-two-exact-source-trees","pageMetadata":{"title":"Compare two exact source trees","description":"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches.\n\nUse this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package.\n\n## Selector catalogue\n\nUse the following selectors with the `fields` query parameter to choose which fields the response includes. See [Choose what the response includes](https://docs.githits.com/api/requests-and-responses#choose-what-the-response-includes) for details.\n\n| Selector | Data | Default |\n| --- | --- | --- |\n| `files` | Identity/status fields and content safety; inventory only | No |\n| `files.stats` | Adds nullable additions/deletions; implies `files` and requests stats | No |\n| `files.patch` | Adds nullable patch and omission reason; implies stats and requests patches | Yes |\n\nFailures use a stable problem document. When supplied by the source, optional recovery hints identify the failed `side`, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 `UNSUPPORTED_REGISTRY`; legally blocked repositories return 451 `REPOSITORY_LEGALLY_BLOCKED`. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response.\n\nFor upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\n","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/code/diff","href":"/api-reference/v1/code-diff/compare-two-exact-source-trees","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n h2: \"h2\",\n p: \"p\",\n table: \"table\",\n tbody: \"tbody\",\n td: \"td\",\n th: \"th\",\n thead: \"thead\",\n tr: \"tr\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Use this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package.\"\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Selector catalogue\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Use the following selectors with the \", _jsx(_components.code, {\n children: \"fields\"\n }), \" query parameter to choose which fields the response includes. See \", _jsx(_components.a, {\n href: \"https://docs.githits.com/api/requests-and-responses#choose-what-the-response-includes\",\n children: \"Choose what the response includes\"\n }), \" for details.\"]\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n children: \"Selector\"\n }), _jsx(_components.th, {\n children: \"Data\"\n }), _jsx(_components.th, {\n children: \"Default\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"files\"\n })\n }), _jsx(_components.td, {\n children: \"Identity/status fields and content safety; inventory only\"\n }), _jsx(_components.td, {\n children: \"No\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"files.stats\"\n })\n }), _jsxs(_components.td, {\n children: [\"Adds nullable additions/deletions; implies \", _jsx(_components.code, {\n children: \"files\"\n }), \" and requests stats\"]\n }), _jsx(_components.td, {\n children: \"No\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"files.patch\"\n })\n }), _jsx(_components.td, {\n children: \"Adds nullable patch and omission reason; implies stats and requests patches\"\n }), _jsx(_components.td, {\n children: \"Yes\"\n })]\n })]\n })]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Failures use a stable problem document. When supplied by the source, optional recovery hints identify the failed \", _jsx(_components.code, {\n children: \"side\"\n }), \", retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 \", _jsx(_components.code, {\n children: \"UNSUPPORTED_REGISTRY\"\n }), \"; legally blocked repositories return 451 \", _jsx(_components.code, {\n children: \"REPOSITORY_LEGALLY_BLOCKED\"\n }), \". A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"For upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\"\n })]\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":"Compare two exact source trees","description":"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches.\n\nUse this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package.\n\n## Selector catalogue\n\nUse the following selectors with the `fields` query parameter to choose which fields the response includes. See [Choose what the response includes](https://docs.githits.com/api/requests-and-responses#choose-what-the-response-includes) for details.\n\n| Selector | Data | Default |\n| --- | --- | --- |\n| `files` | Identity/status fields and content safety; inventory only | No |\n| `files.stats` | Adds nullable additions/deletions; implies `files` and requests stats | No |\n| `files.patch` | Adds nullable patch and omission reason; implies stats and requests patches | Yes |\n\nFailures use a stable problem document. When supplied by the source, optional recovery hints identify the failed `side`, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 `UNSUPPORTED_REGISTRY`; legally blocked repositories return 451 `REPOSITORY_LEGALLY_BLOCKED`. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response.\n\nFor upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\n","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/code/diff","href":"/api-reference/v1/code-diff/compare-two-exact-source-trees","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches.\n\nUse this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package.\n\n## Selector catalogue\n\nUse the following selectors with the `fields` query parameter to choose which fields the response includes. See [Choose what the response includes](https://docs.githits.com/api/requests-and-responses#choose-what-the-response-includes) for details.\n\n| Selector | Data | Default |\n| --- | --- | --- |\n| `files` | Identity/status fields and content safety; inventory only | No |\n| `files.stats` | Adds nullable additions/deletions; implies `files` and requests stats | No |\n| `files.patch` | Adds nullable patch and omission reason; implies stats and requests patches | Yes |\n\nFailures use a stable problem document. When supplied by the source, optional recovery hints identify the failed `side`, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 `UNSUPPORTED_REGISTRY`; legally blocked repositories return 451 `REPOSITORY_LEGALLY_BLOCKED`. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response.\n\nFor upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\n","operationId":"compare_source_trees","parameters":["2eb640cc-63ee-4ce0-b80f-61ae481bba1c","393a0ef1-e262-4963-b3e0-e530f9ef9cd7","0a1a8081-920e-471b-bfc0-3f44e5420a98","d2638170-4fb6-4e65-9ee3-b157adfc7aba","0d5c8996-c2b0-49bd-b52b-a41e845f19bd"],"requestBody":"905b32c1-d3ab-4dc9-8705-af784277e367","responses":{"200":"3284facd-1564-4a42-a06c-23f1088e1ae2","400":"a52053a5-a999-4e7c-b86e-8f42e2328410","401":"ac86e8bc-09a9-4f33-bb1d-6d6dc28a119d","403":"061d31dc-5805-4c8a-8364-69772c777ff2","404":"843da84f-99dc-4764-9272-8540ee098bdd","405":"7d0cceae-f20a-4cef-b870-f3aa2e0f601b","422":"d5713069-de3d-4363-a1b1-45c24c5ca980","429":"f2b475ee-125a-440c-ba72-aeab4d559847","451":"822ae423-5449-4604-b4f7-c83622aff1b1","500":"2c38e955-ef4b-426f-8b99-943054b1eaf9","502":"5cd1bf8b-61f4-48b1-865d-8e70c6a89d0e","503":"0aefe679-1643-4f41-bb4d-e4d35cf9c73e","504":"0493144c-4c17-4911-a415-1e0409c2b5d0"},"security":["dbdba84c-70e6-48ea-b1de-a66c0edc2ff9"],"summary":"Compare two exact source trees","tags":["Code Diff"],"x-codeSamples":[{"label":"Package patch","lang":"HTTP","source":"POST /v1/code/diff HTTP/1.1\nHost: api.githits.dev\nAuthorization: Bearer \u003ctoken>\nContent-Type: application/json\n\n{\"registry\":\"npm\",\"name\":\"express\",\"from_version\":\"4.21.2\",\"to_version\":\"5.1.0\"}"},{"label":"Repository inventory","lang":"HTTP","source":"POST /v1/code/diff?fields=files HTTP/1.1\nHost: api.githits.dev\nAuthorization: Bearer \u003ctoken>\nContent-Type: application/json\n\n{\"repo_url\":\"https://codeberg.org/example/project\",\"from_ref\":\"v1.0.0\",\"to_ref\":\"main\"}"}],"x-githits-cost":1,"x-githits-mcp-tool":"code_diff","x-githits-selection":{"default":["files.patch"],"dependencies":{"files.patch":["files","files.stats"],"files.stats":["files"]},"mandatory_fields":["package","from_resolution","to_resolution","summary","scope","content_coverage","content_failure","files","has_more_files"],"mandatory_file_fields":["path","path_encoding","status","mode_changed","type_changed","content_status","content_safety"],"max_decoded_bytes":2048,"selectors":[{"default":false,"description":"File path, path_encoding, status, mode_changed, type_changed, content_status and content_safety.","groups":["files"],"name":"files"},{"default":false,"description":"Added and deleted line counts; also includes files and requests line statistics.","groups":["files.stats"],"name":"files.stats"},{"default":true,"description":"Patches and omission reasons; also includes files.stats and requests patch content.","groups":["files.patch"],"name":"files.patch"}]},"method":"post","type":"path","servers":["290d7ca6-ea43-4185-8c7a-59b462318783"],"path":"/v1/code/diff","baseUrlOptions":["https://api.githits.dev"],"title":"Compare two exact source trees","codeSamples":[{"label":"Package patch","lang":"HTTP","source":"POST /v1/code/diff HTTP/1.1\nHost: api.githits.dev\nAuthorization: Bearer \u003ctoken>\nContent-Type: application/json\n\n{\"registry\":\"npm\",\"name\":\"express\",\"from_version\":\"4.21.2\",\"to_version\":\"5.1.0\"}"},{"label":"Repository inventory","lang":"HTTP","source":"POST /v1/code/diff?fields=files HTTP/1.1\nHost: api.githits.dev\nAuthorization: Bearer \u003ctoken>\nContent-Type: application/json\n\n{\"repo_url\":\"https://codeberg.org/example/project\",\"from_ref\":\"v1.0.0\",\"to_ref\":\"main\"}"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"2eb640cc-63ee-4ce0-b80f-61ae481bba1c":{"description":"Finite comma-separated selectors: files, files.stats, and files.patch. The default is files.patch. Dependencies are additive; repeated selector tokens are idempotent. Unknown, empty, leaf, and wildcard selectors, plus repeated fields query parameters, are rejected.\n\nUse the case-sensitive selectors in the catalogue. Order and duplicate selectors do not affect the result. ASCII whitespace around selectors is ignored. The decoded value is limited to 2048 UTF-8 bytes. Empty or unknown selectors and repeated `fields` query parameters return `400 VALIDATION_ERROR`. A group does not include nested groups unless the catalogue says so; only listed wildcard bundles are supported.","in":"query","name":"fields","required":false,"schema":{"default":"files.patch","maxLength":2048,"type":"string","isRequired":false,"description":"Finite comma-separated selectors: files, files.stats, and files.patch. The default is files.patch. Dependencies are additive; repeated selector tokens are idempotent. Unknown, empty, leaf, and wildcard selectors, plus repeated fields query parameters, are rejected.\n\nUse the case-sensitive selectors in the catalogue. Order and duplicate selectors do not affect the result. ASCII whitespace around selectors is ignored. The decoded value is limited to 2048 UTF-8 bytes. Empty or unknown selectors and repeated `fields` query parameters return `400 VALIDATION_ERROR`. A group does not include nested groups unless the catalogue says so; only listed wildcard bundles are supported.","uniqueKey":"","typeLabel":"string"}},"393a0ef1-e262-4963-b3e0-e530f9ef9cd7":{"description":"Optional trimmed printable ASCII client name, maximum 80 bytes.","in":"header","name":"X-GitHits-Client-Name","required":false,"schema":{"type":"string","isRequired":false,"description":"Optional trimmed printable ASCII client name, maximum 80 bytes.","uniqueKey":"","typeLabel":"string"}},"0a1a8081-920e-471b-bfc0-3f44e5420a98":{"description":"Optional trimmed printable ASCII client version, maximum 80 bytes.","in":"header","name":"X-GitHits-Client-Version","required":false,"schema":{"type":"string","isRequired":false,"description":"Optional trimmed printable ASCII client version, maximum 80 bytes.","uniqueKey":"","typeLabel":"string"}},"d2638170-4fb6-4e65-9ee3-b157adfc7aba":{"description":"Optional trimmed printable ASCII agent attribution, maximum 160 bytes.","in":"header","name":"X-GitHits-Agent","required":false,"schema":{"type":"string","isRequired":false,"description":"Optional trimmed printable ASCII agent attribution, maximum 160 bytes.","uniqueKey":"","typeLabel":"string"}},"0d5c8996-c2b0-49bd-b52b-a41e845f19bd":{"description":"Optional caller-defined session ID: one to 64 ASCII letters, digits, underscores or hyphens, preserved exactly. Supply the header at most once. Invalid supplied IDs return 400 INVALID_SESSION_ID; no session is created.","in":"header","name":"X-GitHits-Session-ID","required":false,"schema":{"maxLength":64,"minLength":1,"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string","isRequired":false,"description":"Optional caller-defined session ID: one to 64 ASCII letters, digits, underscores or hyphens, preserved exactly. Supply the header at most once. Invalid supplied IDs return 400 INVALID_SESSION_ID; no session is created.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"examples":{"package":{"title":"package","value":{"from_version":"4.21.2","max_files":50,"name":"express","path_glob":"lib/**","registry":"npm","to_version":"5.1.0"}},"repository":{"title":"repository","value":{"from_ref":"v1.0.0","repo_url":"https://gitlab.com/group/project","to_ref":"main"}}},"schema":{"additionalProperties":false,"description":"Compare two package versions or two repository refs.","properties":{"from_ref":{"description":"Explicit base ref, at most 255 UTF-8 bytes.","type":"string","uniqueKey":"from_ref","typeLabel":"string"},"from_version":{"description":"Base package version or registry-compatible constraint.","type":"string","uniqueKey":"from_version","typeLabel":"string"},"max_files":{"default":50,"description":"Maximum relevance-ranked files returned after filtering.","format":"int32","maximum":300,"minimum":1,"type":"integer","uniqueKey":"max_files","typeLabel":"integer\u003cint32>"},"max_patch_bytes":{"default":262144,"description":"Total patch-byte budget, used only when `files.patch` is selected.","format":"int32","maximum":2097152,"minimum":1024,"type":"integer","uniqueKey":"max_patch_bytes","typeLabel":"integer\u003cint32>"},"name":{"description":"Package name; requires registry and both version endpoints.","type":"string","uniqueKey":"name","typeLabel":"string"},"path_glob":{"description":"Repository-relative bounded glob intersected with `path_prefix`.","type":"string","uniqueKey":"path_glob","typeLabel":"string"},"path_prefix":{"description":"Repository-relative component prefix, normalized without edge slashes.","type":"string","uniqueKey":"path_prefix","typeLabel":"string"},"registry":{"description":"Package registry; requires name and both version endpoints.","enum":["npm","pypi","hex","crates","vcpkg","zig","nuget","maven","packagist","rubygems","go","swift"],"type":"string","uniqueKey":"registry","typeLabel":"enum\u003cstring>"},"repo_url":{"description":"Supported credential-free public GitHub, GitLab or Codeberg URL.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"to_ref":{"description":"Explicit head ref, at most 255 UTF-8 bytes.","type":"string","uniqueKey":"to_ref","typeLabel":"string"},"to_version":{"description":"Head package version or registry-compatible constraint.","type":"string","uniqueKey":"to_version","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"3284facd-1564-4a42-a06c-23f1088e1ae2":{"content":{"application/json":{"examples":{"content_failed":{"title":"content_failed","value":{"content_coverage":"failed","content_failure":{"code":"UPSTREAM_ERROR","limit_kind":null,"retry_after_ms":2500,"retryable":true,"stage":"content"},"files":[{"additions":2,"content_omission_reason":null,"content_safety":{"filtered":false,"modifications":[]},"content_status":"patch","deletions":1,"mode_changed":false,"patch":"@@ -1 +1,2 @@\n-old\n+new","path":"lib/application.js","path_encoding":"utf8","status":"modified","type_changed":false}],"from_resolution":{"commit_sha":"0123456789abcdef0123456789abcdef01234567","ref":"refs/tags/4.21.2","ref_kind":"tag","requested":"4.21.2","resolved_version":"4.21.2","version_source":"registry"},"has_more_files":false,"package":{"name":"express","registry":"npm","repo_url":"https://github.com/expressjs/express"},"scope":{"from_subpath":null,"path_glob":null,"path_prefix":null,"status":"repository","to_subpath":null},"summary":{"added":0,"deleted":0,"files_changed":1,"inventory_complete":true,"mode_changed":0,"modified":1,"type_changed":0,"unprojectable_files":0},"to_resolution":{"commit_sha":"fedcba9876543210fedcba9876543210fedcba98","ref":"refs/tags/5.1.0","ref_kind":"tag","requested":"5.1.0","resolved_version":"5.1.0","version_source":"registry"}}},"empty":{"title":"empty","value":{"content_coverage":"complete","content_failure":null,"files":[],"from_resolution":{"commit_sha":"0123456789abcdef0123456789abcdef01234567","ref":"refs/tags/4.21.2","ref_kind":"tag","requested":"4.21.2","resolved_version":"4.21.2","version_source":"registry"},"has_more_files":false,"package":{"name":"express","registry":"npm","repo_url":"https://github.com/expressjs/express"},"scope":{"from_subpath":null,"path_glob":null,"path_prefix":null,"status":"repository","to_subpath":null},"summary":{"added":0,"deleted":0,"files_changed":0,"inventory_complete":true,"mode_changed":0,"modified":0,"type_changed":0,"unprojectable_files":0},"to_resolution":{"commit_sha":"fedcba9876543210fedcba9876543210fedcba98","ref":"refs/tags/5.1.0","ref_kind":"tag","requested":"5.1.0","resolved_version":"5.1.0","version_source":"registry"}}},"inventory_only":{"title":"inventory_only","value":{"content_coverage":"not_requested","content_failure":null,"files":[{"content_safety":{"filtered":false,"modifications":[]},"content_status":"not_requested","mode_changed":false,"path":"lib/application.js","path_encoding":"utf8","status":"modified","type_changed":false}],"from_resolution":{"commit_sha":"0123456789abcdef0123456789abcdef01234567","ref":"refs/tags/4.21.2","ref_kind":"tag","requested":"4.21.2","resolved_version":"4.21.2","version_source":"registry"},"has_more_files":false,"package":{"name":"express","registry":"npm","repo_url":"https://github.com/expressjs/express"},"scope":{"from_subpath":null,"path_glob":null,"path_prefix":null,"status":"repository","to_subpath":null},"summary":{"added":0,"deleted":0,"files_changed":1,"inventory_complete":true,"mode_changed":0,"modified":1,"type_changed":0,"unprojectable_files":0},"to_resolution":{"commit_sha":"fedcba9876543210fedcba9876543210fedcba98","ref":"refs/tags/5.1.0","ref_kind":"tag","requested":"5.1.0","resolved_version":"5.1.0","version_source":"registry"}}},"metadata_only":{"title":"metadata_only","value":{"content_coverage":"complete","content_failure":null,"files":[{"additions":null,"content_omission_reason":null,"content_safety":{"filtered":false,"modifications":[]},"content_status":"metadata_only","deletions":null,"mode_changed":true,"patch":null,"path":"submodule","path_encoding":"utf8","status":"modified","type_changed":true}],"from_resolution":{"commit_sha":"0123456789abcdef0123456789abcdef01234567","ref":"refs/tags/4.21.2","ref_kind":"tag","requested":"4.21.2","resolved_version":"4.21.2","version_source":"registry"},"has_more_files":false,"package":{"name":"express","registry":"npm","repo_url":"https://github.com/expressjs/express"},"scope":{"from_subpath":null,"path_glob":null,"path_prefix":null,"status":"repository","to_subpath":null},"summary":{"added":0,"deleted":0,"files_changed":1,"inventory_complete":true,"mode_changed":0,"modified":1,"type_changed":0,"unprojectable_files":0},"to_resolution":{"commit_sha":"fedcba9876543210fedcba9876543210fedcba98","ref":"refs/tags/5.1.0","ref_kind":"tag","requested":"5.1.0","resolved_version":"5.1.0","version_source":"registry"}}},"partial_content":{"title":"partial_content","value":{"content_coverage":"partial","content_failure":null,"files":[{"additions":null,"content_omission_reason":"total_patch_bytes","content_safety":{"filtered":false,"modifications":[]},"content_status":"omitted","deletions":null,"mode_changed":false,"patch":null,"path":"lib/large.js","path_encoding":"utf8","status":"modified","type_changed":false}],"from_resolution":{"commit_sha":"0123456789abcdef0123456789abcdef01234567","ref":"refs/tags/4.21.2","ref_kind":"tag","requested":"4.21.2","resolved_version":"4.21.2","version_source":"registry"},"has_more_files":false,"package":{"name":"express","registry":"npm","repo_url":"https://github.com/expressjs/express"},"scope":{"from_subpath":null,"path_glob":null,"path_prefix":null,"status":"repository","to_subpath":null},"summary":{"added":0,"deleted":0,"files_changed":1,"inventory_complete":true,"mode_changed":0,"modified":1,"type_changed":0,"unprojectable_files":0},"to_resolution":{"commit_sha":"fedcba9876543210fedcba9876543210fedcba98","ref":"refs/tags/5.1.0","ref_kind":"tag","requested":"5.1.0","resolved_version":"5.1.0","version_source":"registry"}}},"patch":{"title":"patch","value":{"content_coverage":"complete","content_failure":null,"files":[{"additions":2,"content_omission_reason":null,"content_safety":{"filtered":false,"modifications":[]},"content_status":"patch","deletions":1,"mode_changed":false,"patch":"@@ -1 +1,2 @@\n-old\n+new","path":"lib/application.js","path_encoding":"utf8","status":"modified","type_changed":false}],"from_resolution":{"commit_sha":"0123456789abcdef0123456789abcdef01234567","ref":"refs/tags/4.21.2","ref_kind":"tag","requested":"4.21.2","resolved_version":"4.21.2","version_source":"registry"},"has_more_files":false,"package":{"name":"express","registry":"npm","repo_url":"https://github.com/expressjs/express"},"scope":{"from_subpath":null,"path_glob":null,"path_prefix":null,"status":"repository","to_subpath":null},"summary":{"added":0,"deleted":0,"files_changed":1,"inventory_complete":true,"mode_changed":0,"modified":1,"type_changed":0,"unprojectable_files":0},"to_resolution":{"commit_sha":"fedcba9876543210fedcba9876543210fedcba98","ref":"refs/tags/5.1.0","ref_kind":"tag","requested":"5.1.0","resolved_version":"5.1.0","version_source":"registry"}}},"stats":{"title":"stats","value":{"content_coverage":"complete","content_failure":null,"files":[{"additions":2,"content_safety":{"filtered":false,"modifications":[]},"content_status":"stats","deletions":1,"mode_changed":false,"path":"lib/application.js","path_encoding":"utf8","status":"modified","type_changed":false}],"from_resolution":{"commit_sha":"0123456789abcdef0123456789abcdef01234567","ref":"refs/tags/4.21.2","ref_kind":"tag","requested":"4.21.2","resolved_version":"4.21.2","version_source":"registry"},"has_more_files":false,"package":{"name":"express","registry":"npm","repo_url":"https://github.com/expressjs/express"},"scope":{"from_subpath":null,"path_glob":null,"path_prefix":null,"status":"repository","to_subpath":null},"summary":{"added":0,"deleted":0,"files_changed":1,"inventory_complete":true,"mode_changed":0,"modified":1,"type_changed":0,"unprojectable_files":0},"to_resolution":{"commit_sha":"fedcba9876543210fedcba9876543210fedcba98","ref":"refs/tags/5.1.0","ref_kind":"tag","requested":"5.1.0","resolved_version":"5.1.0","version_source":"registry"}}}},"schema":{"description":"Resolved commits, complete inventory counts, and selected file details.","properties":{"content_coverage":{"description":"Coverage of optional content for returned files.","type":"string","isRequired":true,"uniqueKey":"content_coverage","typeLabel":"string"},"content_failure":{"oneOf":[{"type":"null","isRequired":true,"uniqueKey":"content_failure.oneOf.0","typeLabel":"null"},{"type":"object","description":"Bounded content-phase failure; null unless `content_coverage` is failed.","required":["code","retryable","retry_after_ms","stage","limit_kind"],"properties":{"code":{"description":"Stable source failure category.","type":"string","isRequired":true,"uniqueKey":"content_failure.oneOf.1.code","typeLabel":"string"},"limit_kind":{"oneOf":[{"description":"Bounded source limit identifier, when available.","type":"string","isRequired":true,"uniqueKey":"content_failure.oneOf.1.limit_kind.oneOf.0","typeLabel":"string"},{"description":"Bounded source limit identifier, when available.","type":"null","isRequired":true,"uniqueKey":"content_failure.oneOf.1.limit_kind.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content_failure.oneOf.1.limit_kind","typeLabel":"string | null"},"retry_after_ms":{"oneOf":[{"description":"Suggested minimum retry delay in milliseconds, when available.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"content_failure.oneOf.1.retry_after_ms.oneOf.0","typeLabel":"integer\u003cint32>"},{"description":"Suggested minimum retry delay in milliseconds, when available.","format":"int32","minimum":0,"type":"null","isRequired":true,"uniqueKey":"content_failure.oneOf.1.retry_after_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content_failure.oneOf.1.retry_after_ms","typeLabel":"integer\u003cint32> | null"},"retryable":{"description":"Whether unchanged input may succeed when retried.","type":"boolean","isRequired":true,"uniqueKey":"content_failure.oneOf.1.retryable","typeLabel":"boolean"},"stage":{"oneOf":[{"description":"Bounded source stage, when available.","type":"string","isRequired":true,"uniqueKey":"content_failure.oneOf.1.stage.oneOf.0","typeLabel":"string"},{"description":"Bounded source stage, when available.","type":"null","isRequired":true,"uniqueKey":"content_failure.oneOf.1.stage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content_failure.oneOf.1.stage","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"content_failure.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"content_failure","typeLabel":"null | object"},"files":{"description":"Files in relevance order, limited by `max_files`; paths that cannot be represented are omitted.","items":{"description":"One changed file with its status and selected stats or patch.","properties":{"content_safety":{"description":"Source normalization report for path, omission reason and patch.","properties":{"filtered":{"description":"Whether normalization changed any returned path, omission reason, or patch.","type":"boolean","isRequired":true,"uniqueKey":"files.items.[INDEX].content_safety.filtered","typeLabel":"boolean"},"modifications":{"description":"Deduplicated transformations applied by the source.","items":{"description":"Finite transformations applied by the source content-safety pipeline. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: invisible_controls_stripped, html_comments_stripped, images_replaced, unsafe_links_neutralized, unknown.","type":"string","uniqueKey":"files.items.[INDEX].content_safety.modifications.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"files.items.[INDEX].content_safety.modifications","typeLabel":"string[]"}},"required":["filtered","modifications"],"type":"object","isRequired":true,"uniqueKey":"files.items.[INDEX].content_safety","typeLabel":"object"},"content_status":{"description":"Strongest content evidence produced for this row.","type":"string","isRequired":true,"uniqueKey":"files.items.[INDEX].content_status","typeLabel":"string"},"mode_changed":{"description":"Whether the Git file mode changed.","type":"boolean","isRequired":true,"uniqueKey":"files.items.[INDEX].mode_changed","typeLabel":"boolean"},"path":{"description":"Display path; `byte_escaped` paths are not exact read tokens.","type":"string","isRequired":true,"uniqueKey":"files.items.[INDEX].path","typeLabel":"string"},"path_encoding":{"description":"Whether path preserves the original opaque path bytes.","type":"string","isRequired":true,"uniqueKey":"files.items.[INDEX].path_encoding","typeLabel":"string"},"status":{"description":"Directional tree status from base to head.","type":"string","isRequired":true,"uniqueKey":"files.items.[INDEX].status","typeLabel":"string"},"type_changed":{"description":"Whether the Git object kind changed.","type":"boolean","isRequired":true,"uniqueKey":"files.items.[INDEX].type_changed","typeLabel":"boolean"},"additions":{"oneOf":[{"description":"Selected textual inserted-line count; null when unavailable.","format":"int32","minimum":0,"type":"integer","uniqueKey":"files.items.[INDEX].additions.oneOf.0","typeLabel":"integer\u003cint32>"},{"description":"Selected textual inserted-line count; null when unavailable.","format":"int32","minimum":0,"type":"null","uniqueKey":"files.items.[INDEX].additions.oneOf.1","typeLabel":"null"}],"uniqueKey":"files.items.[INDEX].additions","typeLabel":"integer\u003cint32> | null"},"content_omission_reason":{"oneOf":[{"description":"Selected bounded omission reason; null for non-omitted content.","type":"string","uniqueKey":"files.items.[INDEX].content_omission_reason.oneOf.0","typeLabel":"string"},{"description":"Selected bounded omission reason; null for non-omitted content.","type":"null","uniqueKey":"files.items.[INDEX].content_omission_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"files.items.[INDEX].content_omission_reason","typeLabel":"string | null"},"deletions":{"oneOf":[{"description":"Selected textual deleted-line count; null when unavailable.","format":"int32","minimum":0,"type":"integer","uniqueKey":"files.items.[INDEX].deletions.oneOf.0","typeLabel":"integer\u003cint32>"},{"description":"Selected textual deleted-line count; null when unavailable.","format":"int32","minimum":0,"type":"null","uniqueKey":"files.items.[INDEX].deletions.oneOf.1","typeLabel":"null"}],"uniqueKey":"files.items.[INDEX].deletions","typeLabel":"integer\u003cint32> | null"},"patch":{"oneOf":[{"description":"Selected bounded unified patch; null for non-text or omitted content.","type":"string","uniqueKey":"files.items.[INDEX].patch.oneOf.0","typeLabel":"string"},{"description":"Selected bounded unified patch; null for non-text or omitted content.","type":"null","uniqueKey":"files.items.[INDEX].patch.oneOf.1","typeLabel":"null"}],"uniqueKey":"files.items.[INDEX].patch","typeLabel":"string | null"}},"required":["path","path_encoding","status","mode_changed","type_changed","content_status","content_safety"],"type":"object","uniqueKey":"files.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"files","typeLabel":"object[]"},"from_resolution":{"description":"Immutable base-side resolution used by the diff.","properties":{"commit_sha":{"description":"Full immutable commit SHA used for the exact-tree comparison.","type":"string","isRequired":true,"uniqueKey":"from_resolution.commit_sha","typeLabel":"string"},"ref":{"description":"Resolved checkout ref retained as provenance, not identity.","type":"string","isRequired":true,"uniqueKey":"from_resolution.ref","typeLabel":"string"},"ref_kind":{"description":"Source classification of the resolved ref.","type":"string","isRequired":true,"uniqueKey":"from_resolution.ref_kind","typeLabel":"string"},"requested":{"description":"Exact version constraint or ref spelling supplied by the caller.","type":"string","isRequired":true,"uniqueKey":"from_resolution.requested","typeLabel":"string"},"resolved_version":{"oneOf":[{"description":"Exact published version selected for package addressing; null for repositories.","type":"string","isRequired":true,"uniqueKey":"from_resolution.resolved_version.oneOf.0","typeLabel":"string"},{"description":"Exact published version selected for package addressing; null for repositories.","type":"null","isRequired":true,"uniqueKey":"from_resolution.resolved_version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"from_resolution.resolved_version","typeLabel":"string | null"},"version_source":{"oneOf":[{"type":"null","isRequired":true,"uniqueKey":"from_resolution.version_source.oneOf.0","typeLabel":"null"},{"type":"string","description":"Package version-to-ref evidence source; null for repositories.","isRequired":true,"uniqueKey":"from_resolution.version_source.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"from_resolution.version_source","typeLabel":"null | string"}},"required":["requested","resolved_version","ref","commit_sha","ref_kind","version_source"],"type":"object","isRequired":true,"uniqueKey":"from_resolution","typeLabel":"object"},"has_more_files":{"description":"Whether additional matching files with representable paths were omitted by `max_files`.","type":"boolean","isRequired":true,"uniqueKey":"has_more_files","typeLabel":"boolean"},"package":{"oneOf":[{"type":"null","isRequired":true,"uniqueKey":"package.oneOf.0","typeLabel":"null"},{"type":"object","description":"Canonical package identity; null for repository addressing.","required":["registry","name","repo_url"],"properties":{"name":{"description":"Canonical registry package name.","type":"string","isRequired":true,"uniqueKey":"package.oneOf.1.name","typeLabel":"string"},"registry":{"description":"Canonical package registry.","type":"string","isRequired":true,"uniqueKey":"package.oneOf.1.registry","typeLabel":"string"},"repo_url":{"description":"Canonical supported public repository URL.","type":"string","isRequired":true,"uniqueKey":"package.oneOf.1.repo_url","typeLabel":"string"}},"isRequired":true,"uniqueKey":"package.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"package","typeLabel":"null | object"},"scope":{"description":"Effective repository inventory scope and caller filters.","properties":{"from_subpath":{"oneOf":[{"description":"Package subdirectory; null for repository-wide comparisons.","type":"string","isRequired":true,"uniqueKey":"scope.from_subpath.oneOf.0","typeLabel":"string"},{"description":"Package subdirectory; null for repository-wide comparisons.","type":"null","isRequired":true,"uniqueKey":"scope.from_subpath.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"scope.from_subpath","typeLabel":"string | null"},"path_glob":{"oneOf":[{"description":"Caller glob exactly as accepted; null when omitted.","type":"string","isRequired":true,"uniqueKey":"scope.path_glob.oneOf.0","typeLabel":"string"},{"description":"Caller glob exactly as accepted; null when omitted.","type":"null","isRequired":true,"uniqueKey":"scope.path_glob.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"scope.path_glob","typeLabel":"string | null"},"path_prefix":{"oneOf":[{"description":"Normalized caller prefix; null when omitted.","type":"string","isRequired":true,"uniqueKey":"scope.path_prefix.oneOf.0","typeLabel":"string"},{"description":"Normalized caller prefix; null when omitted.","type":"null","isRequired":true,"uniqueKey":"scope.path_prefix.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"scope.path_prefix","typeLabel":"string | null"},"status":{"description":"Source-reported scope; current successful execution is repository.","type":"string","isRequired":true,"uniqueKey":"scope.status","typeLabel":"string"},"to_subpath":{"oneOf":[{"description":"Package subdirectory; null for repository-wide comparisons.","type":"string","isRequired":true,"uniqueKey":"scope.to_subpath.oneOf.0","typeLabel":"string"},{"description":"Package subdirectory; null for repository-wide comparisons.","type":"null","isRequired":true,"uniqueKey":"scope.to_subpath.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"scope.to_subpath","typeLabel":"string | null"}},"required":["status","from_subpath","to_subpath","path_prefix","path_glob"],"type":"object","isRequired":true,"uniqueKey":"scope","typeLabel":"object"},"summary":{"description":"Complete counts of matching repository changes, before limiting returned files.","properties":{"added":{"description":"Paths present only in the head tree.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"summary.added","typeLabel":"integer\u003cint32>"},"deleted":{"description":"Paths present only in the base tree.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"summary.deleted","typeLabel":"integer\u003cint32>"},"files_changed":{"description":"Changed paths, including paths omitted because they cannot be represented or exceed `max_files`.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"summary.files_changed","typeLabel":"integer\u003cint32>"},"inventory_complete":{"description":"Always true on success: inventory enumeration completed, even if file details are limited.","type":"boolean","isRequired":true,"uniqueKey":"summary.inventory_complete","typeLabel":"boolean"},"mode_changed":{"description":"Modified paths whose Git mode changed.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"summary.mode_changed","typeLabel":"integer\u003cint32>"},"modified":{"description":"Paths present in both trees and changed.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"summary.modified","typeLabel":"integer\u003cint32>"},"type_changed":{"description":"Modified paths whose Git object kind changed.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"summary.type_changed","typeLabel":"integer\u003cint32>"},"unprojectable_files":{"description":"Matching paths too long to represent; included in summary counts but omitted from files.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"summary.unprojectable_files","typeLabel":"integer\u003cint32>"}},"required":["files_changed","added","deleted","modified","mode_changed","type_changed","inventory_complete","unprojectable_files"],"type":"object","isRequired":true,"uniqueKey":"summary","typeLabel":"object"},"to_resolution":{"description":"Immutable head-side resolution used by the diff.","properties":{"commit_sha":{"description":"Full immutable commit SHA used for the exact-tree comparison.","type":"string","isRequired":true,"uniqueKey":"to_resolution.commit_sha","typeLabel":"string"},"ref":{"description":"Resolved checkout ref retained as provenance, not identity.","type":"string","isRequired":true,"uniqueKey":"to_resolution.ref","typeLabel":"string"},"ref_kind":{"description":"Source classification of the resolved ref.","type":"string","isRequired":true,"uniqueKey":"to_resolution.ref_kind","typeLabel":"string"},"requested":{"description":"Exact version constraint or ref spelling supplied by the caller.","type":"string","isRequired":true,"uniqueKey":"to_resolution.requested","typeLabel":"string"},"resolved_version":{"oneOf":[{"description":"Exact published version selected for package addressing; null for repositories.","type":"string","isRequired":true,"uniqueKey":"to_resolution.resolved_version.oneOf.0","typeLabel":"string"},{"description":"Exact published version selected for package addressing; null for repositories.","type":"null","isRequired":true,"uniqueKey":"to_resolution.resolved_version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"to_resolution.resolved_version","typeLabel":"string | null"},"version_source":{"oneOf":[{"type":"null","isRequired":true,"uniqueKey":"to_resolution.version_source.oneOf.0","typeLabel":"null"},{"type":"string","description":"Package version-to-ref evidence source; null for repositories.","isRequired":true,"uniqueKey":"to_resolution.version_source.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"to_resolution.version_source","typeLabel":"null | string"}},"required":["requested","resolved_version","ref","commit_sha","ref_kind","version_source"],"type":"object","isRequired":true,"uniqueKey":"to_resolution","typeLabel":"object"}},"required":["package","from_resolution","to_resolution","summary","scope","content_coverage","content_failure","files","has_more_files"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Exact-tree inventory and selected content evidence","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests in the authenticated usage window shared across operations. Optional: supplied only when usage metadata is available.","schema":{"pattern":"^[0-9]+$","type":"string"}},"X-RateLimit-Remaining":{"description":"Requests remaining in that usage window after admission. Advisory snapshot; concurrent requests can consume quota. Optional when usage metadata is unavailable.","schema":{"pattern":"^[0-9]+$","type":"string"}},"X-RateLimit-Reset":{"description":"Usage window reset time as Unix epoch seconds (UTC), rounded up to the next whole second. This is an absolute timestamp, not a delay. Optional when usage metadata is unavailable. Honor Retry-After on 429 when present; other quotas can also reject requests.","schema":{"pattern":"^[0-9]+$","type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"a52053a5-a999-4e7c-b86e-8f42e2328410":{"content":{"application/problem+json":{"examples":{"invalid_session_id":{"title":"invalid_session_id","value":{"code":"INVALID_SESSION_ID","detail":"X-GitHits-Session-ID must occur once and match [A-Za-z0-9_-]{1,64}.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":400,"title":"Invalid session ID","type":"about:blank"}},"upstream_validation":{"title":"upstream_validation","value":{"code":"VALIDATION_ERROR","detail":"The request is invalid.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":400,"title":"Validation error","type":"about:blank"}},"validation":{"title":"validation","value":{"code":"VALIDATION_ERROR","detail":"query: contains unknown parameters; use only the documented parameters.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":400,"title":"Validation error","type":"about:blank"}}},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"VALIDATION_ERROR INVALID_SESSION_ID: a supplied session header is invalid or duplicated. VALIDATION_ERROR details identify the first invalid field and a reason when available. Array indices are zero-based; submitted values and unknown keys are not echoed.","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"ac86e8bc-09a9-4f33-bb1d-6d6dc28a119d":{"content":{"application/problem+json":{"example":{"code":"AUTHENTICATION_REQUIRED","detail":"A bearer credential is required.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":401,"title":"Authentication required","type":"about:blank"},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"AUTHENTICATION_REQUIRED","detail":"A bearer credential is required.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":401,"title":"Authentication required","type":"about:blank"}}},"exampleType":"examples"}},"description":"AUTHENTICATION_REQUIRED","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"WWW-Authenticate":{"description":"Bearer challenge.","schema":{"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"061d31dc-5805-4c8a-8364-69772c777ff2":{"content":{"application/problem+json":{"example":{"code":"FORBIDDEN","detail":"The caller is not allowed to access this resource.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":403,"title":"Forbidden","type":"about:blank"},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"FORBIDDEN","detail":"The caller is not allowed to access this resource.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":403,"title":"Forbidden","type":"about:blank"}}},"exampleType":"examples"}},"description":"FORBIDDEN, ACCOUNT_INACTIVE, FEATURE_FLAG_REQUIRED, TERMS_ACCEPTANCE_REQUIRED","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"843da84f-99dc-4764-9272-8540ee098bdd":{"content":{"application/problem+json":{"examples":{"missing_ref":{"title":"missing_ref","value":{"available_refs":[{"ref":"main","version":null}],"code":"REF_NOT_FOUND","detail":"The requested repository ref was not found.","git_ref":"missing","instance":"4bf92f3577b34da6a3ce929d0e0e4736","repo_url":"https://github.com/example/project","retryable":false,"side":"to","status":404,"suggested_refs":[{"ref":"v1","version":"1.0.0"}],"title":"Ref not found","type":"about:blank"}},"missing_version":{"title":"missing_version","value":{"available_versions":[{"ref":"v4.21.2","version":"4.21.2"}],"code":"VERSION_NOT_FOUND","detail":"The requested package version was not found.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","published_versions":["4.21.2"],"published_versions_truncated":false,"retryable":false,"side":"from","status":404,"title":"Version not found","type":"about:blank"}}},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"PACKAGE_NOT_FOUND, NO_RELEASED_VERSIONS, VERSION_NOT_FOUND, REPOSITORY_NOT_FOUND, REF_NOT_FOUND","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"7d0cceae-f20a-4cef-b870-f3aa2e0f601b":{"content":{"application/problem+json":{"example":{"code":"METHOD_NOT_ALLOWED","detail":"The requested method is not supported for this route.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":405,"title":"Method not allowed","type":"about:blank"},"schema":{"description":"The stable problem document returned for an unsuccessful public API request.","properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"description":"Whether retrying later may help, when supplied. Follow this flag for lookup/provider outcomes and temporary daily-allowance failures; malformed evidence can be nonretryable.","type":"boolean","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"}},"required":["type","title","status","detail","instance","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"METHOD_NOT_ALLOWED","detail":"The requested method is not supported for this route.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":405,"title":"Method not allowed","type":"about:blank"}}},"exampleType":"examples"}},"description":"METHOD_NOT_ALLOWED: the route does not support this HTTP method.","headers":{"Allow":{"description":"Supported methods: POST.","schema":{"type":"string"}},"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"X-Request-ID":{"description":"Request trace ID for diagnostics; matches problem.instance on failures.","schema":{"type":"string"}}},"exampleType":"examples"},"d5713069-de3d-4363-a1b1-45c24c5ca980":{"content":{"application/problem+json":{"examples":{"raw_limit":{"title":"raw_limit","value":{"code":"RAW_DIFF_LIMIT_EXCEEDED","detail":"The exact-tree comparison exceeded a bounded source limit.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","limit_kind":"output_bytes","retryable":false,"stage":"output","status":422,"title":"Raw diff limit exceeded","type":"about:blank"}},"unsupported_source":{"title":"unsupported_source","value":{"code":"UNSUPPORTED_REGISTRY","detail":"The package registry or its source repository is not supported.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","registry":"npm","retryable":false,"side":"from","status":422,"title":"Unsupported source","type":"about:blank"}}},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"UNSUPPORTED_PACKAGE_VARIANTS, UNSUPPORTED_REGISTRY, AMBIGUOUS_REF, REF_UNRESOLVABLE, RAW_DIFF_LIMIT_EXCEEDED","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"f2b475ee-125a-440c-ba72-aeab4d559847":{"content":{"application/problem+json":{"examples":{"rate_limit":{"title":"rate_limit","value":{"code":"RATE_LIMITED","detail":"The request was rate limited.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","retry_after_ms":1001,"retryable":true,"status":429,"title":"Rate limited","type":"about:blank"}}},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"RATE_LIMITED RATE_LIMITED can also mean your shared daily allowance is exhausted. When Retry-After is supplied, wait until that delay or HTTP date before trying again.","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"Retry-After":{"description":"Optional bounded delta seconds or HTTP date.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests in the authenticated usage window shared across operations. Optional: supplied only when usage metadata is available.","schema":{"pattern":"^[0-9]+$","type":"string"}},"X-RateLimit-Remaining":{"description":"Requests remaining in that usage window after admission. Advisory snapshot; concurrent requests can consume quota. Optional when usage metadata is unavailable.","schema":{"pattern":"^[0-9]+$","type":"string"}},"X-RateLimit-Reset":{"description":"Usage window reset time as Unix epoch seconds (UTC), rounded up to the next whole second. This is an absolute timestamp, not a delay. Optional when usage metadata is unavailable. Honor Retry-After on 429 when present; other quotas can also reject requests.","schema":{"pattern":"^[0-9]+$","type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"822ae423-5449-4604-b4f7-c83622aff1b1":{"content":{"application/problem+json":{"examples":{"legally_blocked":{"title":"legally_blocked","value":{"code":"REPOSITORY_LEGALLY_BLOCKED","detail":"The source repository is unavailable for legal reasons.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","retryable":false,"side":"to","status":451,"title":"Repository legally blocked","type":"about:blank"}}},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"REPOSITORY_LEGALLY_BLOCKED","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"2c38e955-ef4b-426f-8b99-943054b1eaf9":{"description":"A request ID could not be assigned. The response has an empty body and no X-Request-ID or problem object; try again later.","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}}},"x-githits-empty-identity-failure":true,"content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"5cd1bf8b-61f4-48b1-865d-8e70c6a89d0e":{"content":{"application/problem+json":{"example":{"code":"UPSTREAM_ERROR","detail":"The upstream service returned malformed evidence or failed.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":502,"title":"Upstream error","type":"about:blank"},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"UPSTREAM_ERROR","detail":"The upstream service returned malformed evidence or failed.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":502,"title":"Upstream error","type":"about:blank"}}},"exampleType":"examples"}},"description":"UPSTREAM_ERROR","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"0aefe679-1643-4f41-bb4d-e4d35cf9c73e":{"content":{"application/problem+json":{"example":{"code":"PACKAGE_INDEXING","detail":"Source indexing is still in progress or required raw inventory is unavailable.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":503,"title":"Comparison unavailable","type":"about:blank"},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"PACKAGE_INDEXING","detail":"Source indexing is still in progress or required raw inventory is unavailable.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":503,"title":"Comparison unavailable","type":"about:blank"}}},"exampleType":"examples"}},"description":"PACKAGE_INDEXING, RAW_DIFF_UNAVAILABLE QUOTA_UNAVAILABLE: your daily allowance could not be checked. This is temporary; retry the same request later (retryable=true).","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"},"0493144c-4c17-4911-a415-1e0409c2b5d0":{"content":{"application/problem+json":{"example":{"code":"TIMEOUT","detail":"The comparison did not complete within the operation deadline.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":504,"title":"Upstream timeout","type":"about:blank"},"schema":{"type":"object","description":"Problem response with optional hints for correcting or retrying the request.","required":["type","title","status","detail","instance","code"],"properties":{"code":{"description":"The stable uppercase API error code.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"description":"Human-readable explanation. Wording can change; use code and structured fields for program logic. Validation errors identify the first invalid field (including zero-based array indices) and a reason; version errors can include canonical-version guidance.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"Request ID matching the X-Request-ID response header; include it when seeking support.","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"status":{"description":"The HTTP status returned with this problem.","format":"int32","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"description":"A short, stable title for the error.","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The generic RFC 9457 problem type.","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"acceptance_url":{"description":"Link for accepting the required terms, when provided.","type":"string","uniqueKey":"acceptance_url","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the request may succeed without changing its input.","uniqueKey":"retryable","typeLabel":"boolean"},"terms_url":{"description":"Link to the terms that require acceptance, when provided.","type":"string","uniqueKey":"terms_url","typeLabel":"string"},"available_refs":{"description":"Indexed source ref/version alternatives in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"available_refs","typeLabel":"object[]"},"available_versions":{"description":"Available source refs paired with published package versions when known.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"available_versions.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"available_versions.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"available_versions","typeLabel":"object[]"},"git_ref":{"description":"Requested repository ref associated with the failure.","maxLength":255,"type":"string","uniqueKey":"git_ref","typeLabel":"string"},"limit_kind":{"description":"Bounded raw-diff limit identifier.","maxLength":64,"type":"string","uniqueKey":"limit_kind","typeLabel":"string"},"published_versions":{"description":"Published package version suggestions in source order; not a complete inventory.","items":{"type":"string","uniqueKey":"published_versions.items.[INDEX]","typeLabel":"string"},"maxItems":50,"type":"array","uniqueKey":"published_versions","typeLabel":"string[]"},"published_versions_truncated":{"description":"Whether more published version suggestions were omitted by the source.","type":"boolean","uniqueKey":"published_versions_truncated","typeLabel":"boolean"},"ref_kinds":{"description":"Source ref kinds that make the requested name ambiguous.","items":{"description":"How a repository ref was classified before exact-SHA resolution. Response values can evolve: accept values you do not recognise. A value the API does not yet recognise is returned as unknown. Known values include: sha, tag, branch, head, unknown.","type":"string","uniqueKey":"ref_kinds.items.[INDEX]","typeLabel":"string"},"maxItems":4,"type":"array","uniqueKey":"ref_kinds","typeLabel":"string[]"},"registry":{"description":"Supported package registry associated with this failure.","type":"string","uniqueKey":"registry","typeLabel":"string"},"repo_url":{"description":"Credential-free supported repository URL associated with the failure.","type":"string","uniqueKey":"repo_url","typeLabel":"string"},"retry_after_ms":{"description":"Source retry delay in milliseconds; Retry-After header takes precedence.","format":"int32","maximum":2147483647,"minimum":0,"type":"integer","uniqueKey":"retry_after_ms","typeLabel":"integer\u003cint32>"},"side":{"description":"Comparison endpoint whose resolution failed.","enum":["from","to"],"type":"string","uniqueKey":"side","typeLabel":"enum\u003cstring>"},"stage":{"description":"Comparison stage associated with the failure, when available.","maxLength":64,"type":"string","uniqueKey":"stage","typeLabel":"string"},"suggested_refs":{"description":"Nearby source ref/version suggestions in source order.","items":{"description":"Ordered source alternative; version is null for an unpaired repository ref.","properties":{"ref":{"description":"Exact source ref spelling supplied as recovery guidance.","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].ref","typeLabel":"string"},"version":{"oneOf":[{"description":"Published package version, when known.","maxLength":100,"type":"string","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.0","typeLabel":"string"},{"description":"Published package version, when known.","maxLength":100,"type":"null","isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggested_refs.items.[INDEX].version","typeLabel":"string | null"}},"required":["ref","version"],"type":"object","uniqueKey":"suggested_refs.items.[INDEX]","typeLabel":"object"},"maxItems":5,"type":"array","uniqueKey":"suggested_refs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"TIMEOUT","detail":"The comparison did not complete within the operation deadline.","instance":"4bf92f3577b34da6a3ce929d0e0e4736","status":504,"title":"Upstream timeout","type":"about:blank"}}},"exampleType":"examples"}},"description":"TIMEOUT","headers":{"Cache-Control":{"schema":{"enum":["no-store"],"type":"string"}},"x-request-id":{"description":"Active trace identity, also problem.instance.","schema":{"type":"string"}}},"exampleType":"examples"}},"security":{"dbdba84c-70e6-48ea-b1de-a66c0edc2ff9":{"bearer_auth":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer_auth"}}},"servers":{"290d7ca6-ea43-4185-8c7a-59b462318783":{"description":"Production","url":"https://api.githits.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer_auth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer_auth","name":"Authorization"}],"title":"bearer_auth"}]},"originalFileLocation":"https://api.githits.dev/v1/openapi.json"},"subdomain":"githits","siteName":"GitHits","title":"Compare two exact source trees - GitHits","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T08:55:38.153Z","originalFileLocation":"api-reference/v1/code-diff/compare-two-exact-source-trees.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=\"dark\"}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=\"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches. Use this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package. ## Selector catalogue Use the following selectors with the fields query parameter to choose which fields the response includes. See Choose what the response includes for details. | Selector | Data | Default | | --- | --- | --- | | files | Identity/status fields and content safety; inventory only | No | | files.stats | Adds nullable additions/deletions; implies files and requests stats | No | | files.patch | Adds nullable patch and omission reason; implies stats and requests patches | Yes | Failures use a stable problem document. When supplied by the source, optional recovery hints identify the failed side, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 UNSUPPORTED_REGISTRY; legally blocked repositories return 451 REPOSITORY_LEGALLY_BLOCKED. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response. For upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\">\u003cmeta data-mint-head name=\"application-name\" content=\"GitHits\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/githits/hPN3FB6to_tLCtYP/_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/githits/hPN3FB6to_tLCtYP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/githits/hPN3FB6to_tLCtYP/_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/githits/hPN3FB6to_tLCtYP/_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/githits/hPN3FB6to_tLCtYP/_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/githits/hPN3FB6to_tLCtYP/_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/githits/hPN3FB6to_tLCtYP/_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/githits/hPN3FB6to_tLCtYP/_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/githits/hPN3FB6to_tLCtYP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Compare two exact source trees - GitHits\">\u003cmeta data-mint-head property=\"og:description\" content=\"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches. Use this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package. ## Selector catalogue Use the following selectors with the fields query parameter to choose which fields the response includes. See Choose what the response includes for details. | Selector | Data | Default | | --- | --- | --- | | files | Identity/status fields and content safety; inventory only | No | | files.stats | Adds nullable additions/deletions; implies files and requests stats | No | | files.patch | Adds nullable patch and omission reason; implies stats and requests patches | Yes | Failures use a stable problem document. When supplied by the source, optional recovery hints identify the failed side, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 UNSUPPORTED_REGISTRY; legally blocked repositories return 451 REPOSITORY_LEGALLY_BLOCKED. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response. For upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GitHits\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://githits.mintlify.site/_mintlify/api/og/v2?division=Code+Diff\u0026amp;title=Compare+two+exact+source+trees\u0026amp;description=Compare+source+changes+between+two+package+versions+or+two+refs+in+a+public+repository.+The+response+lists+changed+files+and+can+include+added+and+deleted+line+\u0026amp;theme=72c2abfbe4dc3e534d267019\u0026amp;signature=bd6af17640d522452a7d49130c0f21359b69da0a748da0b3dabf1136a7f4554b\">\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=\"Compare two exact source trees - GitHits\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches. Use this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package. ## Selector catalogue Use the following selectors with the fields query parameter to choose which fields the response includes. See Choose what the response includes for details. | Selector | Data | Default | | --- | --- | --- | | files | Identity/status fields and content safety; inventory only | No | | files.stats | Adds nullable additions/deletions; implies files and requests stats | No | | files.patch | Adds nullable patch and omission reason; implies stats and requests patches | Yes | Failures use a stable problem document. When supplied by the source, optional recovery hints identify the failed side, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 UNSUPPORTED_REGISTRY; legally blocked repositories return 451 REPOSITORY_LEGALLY_BLOCKED. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response. For upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://githits.mintlify.site/_mintlify/api/og/v2?division=Code+Diff\u0026amp;title=Compare+two+exact+source+trees\u0026amp;description=Compare+source+changes+between+two+package+versions+or+two+refs+in+a+public+repository.+The+response+lists+changed+files+and+can+include+added+and+deleted+line+\u0026amp;theme=72c2abfbe4dc3e534d267019\u0026amp;signature=bd6af17640d522452a7d49130c0f21359b69da0a748da0b3dabf1136a7f4554b\">\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/githits/hPN3FB6to_tLCtYP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GitHits\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#cc3f8b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v1/code-diff/compare-two-exact-source-trees.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.githits.com/#organization\",\"name\":\"GitHits\",\"url\":\"https://docs.githits.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/githits/nEuGn8_ZROo1DncD/images/githits-wordmark.svg?fit=max\u0026auto=format\u0026n=nEuGn8_ZROo1DncD\u0026q=85\u0026s=33b1a4083b1476ad8520731d35d55987\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.githits.com#website\",\"name\":\"GitHits\",\"url\":\"https://docs.githits.com\",\"publisher\":{\"@id\":\"https://docs.githits.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees#webpage\",\"url\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees\",\"name\":\"Compare two exact source trees\",\"description\":\"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches. Use this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package. ## Selector catalogue Use the following selectors with the fields query parameter to choose which fields the response includes. See Choose what the response includes for details. | Selector | Data | Default | | --- | --- | --- | | files | Identity/status fields and content safety; inventory only | No | | files.stats | Adds nullable additions/deletions; implies files and requests stats | No | | files.patch | Adds nullable patch and omission reason; implies stats and requests patches | Yes | Failures use a stable problem document. When supplied by the source, optional recovery hints identify the failed side, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 UNSUPPORTED_REGISTRY; legally blocked repositories return 451 REPOSITORY_LEGALLY_BLOCKED. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response. For upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\",\"dateModified\":\"2026-11-09T08:55:38.153Z\",\"isPartOf\":{\"@id\":\"https://docs.githits.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"v1 reference\",\"item\":\"https://docs.githits.com/api-reference/v1/packages/get-a-package-or-repository-changelog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Compare two exact source trees\",\"item\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees#apireference\",\"headline\":\"Compare two exact source trees\",\"name\":\"Compare two exact source trees\",\"description\":\"Compare source changes between two package versions or two refs in a public repository. The response lists changed files and can include added and deleted line counts and patches. Use this endpoint to inspect the code behind a release or upgrade. Comparisons cover the whole repository, including when you identify it through a package. ## Selector catalogue Use the following selectors with the fields query parameter to choose which fields the response includes. See Choose what the response includes for details. | Selector | Data | Default | | --- | --- | --- | | files | Identity/status fields and content safety; inventory only | No | | files.stats | Adds nullable additions/deletions; implies files and requests stats | No | | files.patch | Adds nullable patch and omission reason; implies stats and requests patches | Yes | Failures use a stable problem document. When supplied by the source, optional recovery hints identify the failed side, retryability, published versions, and ordered source ref/version alternatives. Missing hints are omitted. Classified user-facing errors use nonempty REST-suitable source guidance as detail; otherwise gateway text is used. Internal diagnostics remain private. Detail wording is not stable; use code and recovery fields. Unsupported package registries or repository providers return 422 UNSUPPORTED_REGISTRY; legally blocked repositories return 451 REPOSITORY_LEGALLY_BLOCKED. A root inventory failure is a problem response, while qualified partial or failed content remains a successful inventory response. For upgrade decisions, combine source changes with dependency, advisory and behavior compatibility evidence. Inventory remains authoritative when patches are truncated, filtered, or unavailable; byte-escaped paths are display identities and cannot be used as exact read tokens.\",\"url\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees\",\"mainEntityOfPage\":{\"@id\":\"https://docs.githits.com/api-reference/v1/code-diff/compare-two-exact-source-trees#webpage\"},\"dateModified\":\"2026-11-09T08:55:38.153Z\",\"publisher\":{\"@id\":\"https://docs.githits.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.githits.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GitHits\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"GitHits\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v1/code-diff/compare-two-exact-source-trees.md","siteName":"GitHits","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API","groups":[{"group":"Get started","pages":[{"title":"GitHits REST API","sidebarTitle":"Overview","href":"/api/overview"},{"title":"API quickstart","href":"/api/quickstart"},{"title":"API authentication","href":"/api/authentication"},{"title":"Requests and responses","href":"/api/requests-and-responses"},{"title":"SBOM, audit and licenses","sidebarTitle":"SBOM, audit and licenses","href":"/api/lockfile-analysis"},{"title":"API errors","href":"/api/errors"},{"title":"API versioning","href":"/api/versioning"}]},{"group":"v1 reference","pages":[{"group":"Packages","pages":[{"title":"Get a package or repository changelog","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/changelog","href":"/api-reference/v1/packages/get-a-package-or-repository-changelog"},{"title":"Review package upgrades","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/package-upgrade-reviews","href":"/api-reference/v1/packages/review-package-upgrades"},{"title":"Inspect a package release","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/packages/{registry}/{name}","href":"/api-reference/v1/packages/inspect-a-package-release"},{"title":"Inspect package dependencies","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/packages/{registry}/{name}/dependencies","href":"/api-reference/v1/packages/inspect-package-dependencies"},{"title":"Inspect package vulnerabilities","description":"Find known security advisories for a package version, with assessment reasons, severity evidence, affected-version displays and evaluated source fix candidates.\n\nOmit `version` to use the package's default for reads: its native install default, otherwise the registry's reported latest version, otherwise the latest stable inventory version (or latest inventory version if none is stable). The returned `package.version` identifies the inspected version; it can be null when none is available. Provide an exact version or supported constraint to choose a version explicitly.\n\n**Start with `vulnerabilities.summary`.** `assessment_status` describes the result, `assessment_reasons` explains evidence that could not be evaluated, and `current_version_affected` is nullable. A confirmed affected match remains `affected`/`true` even when other evidence is incomplete. `unknown`, `not_assessed` and `unsupported` never establish a clear release. Null affectedness means undetermined. A null package version means no concrete release was inspected.\n\nCounts describe affected, non-affecting, unknown and all advisories after severity and withdrawal filters and source deduplication. For an inspected release the three applicability counts sum to all; package history can instead have a positive all count with zero applicability counts. `advisory_scope` selects rows and their page total, independently of summary count scopes. Use `advisory_scope=unknown` to investigate unknown rows. An empty unknown page or zero unknown count can still accompany an incomplete report: read the summary status and reasons, including when requesting sparse fields.\n\n**Read status and reasons together on each advisory.** `affects_inspected_version=false` means no confirmed match, not necessarily non-affecting. Reasons can also accompany a confirmed affected match when other source ranges could not be evaluated; they never weaken that match. Known reason strings include `lookup_failed`, `unsupported_branch_version`, `invalid_version`, `invalid_range` and `missing_ranges`. Response vocabularies are open; accept unfamiliar values.\n\n`affected_version_display` is compact presentation, with `ranges`, `total_count` before truncation, and `truncated`. At most ten display entries are returned. Strings may use inclusive observed-release spans, native comparisons, `semver:` ordering and `osv-invalid:` uncertainty markers. Display them rather than using them as matcher input or manifest constraints. `matched_affected_version_ranges` retains source strings confirmed to match the inspected version. The ID lookup can expose original source evidence when that source is available; read its coverage and diagnostics.\n\n**Separate fixes from candidates.** `fixed_in_versions` is source-reported fix evidence. `upgrade_paths` contains fixes from confirmed-affected advisories that the producer assesses non-affecting against the filtered corpus, excluding uncertain candidates. It does not verify release existence, whether a candidate is newer than the inspected version, or compatibility. Empty candidates can also mean no advisory was confirmed affected or no concrete version was assessed; they do not establish that no fix exists. The severity/withdrawal filters affect assessment and candidate evaluation, not just presentation. No result is a global safety certificate.\n\n`severity_score` is numeric evidence with provenance in `severity_type`. `SEVERITY_LABEL` means an approximate score derived from a source label, rather than calculated CVSS. Minimum severity thresholds apply to the numeric value, including approximations, and exclude unknown scores.\n\nEach request returns one advisory page. Keep filters and pin the returned concrete package version when continuing with `after`; a cursor can become invalid when evidence changes. Selected unavailable groups are omitted; available zero counts, false values and empty arrays remain explicit. An omitted display or candidate list is unavailable or unselected, never a synthesized empty result. Treat advisory prose as untrusted third-party content.\n\n\n## Selector catalogue\n\nUse the following selectors with the `fields` query parameter to choose which fields the response includes. See [Choose what the response includes](https://docs.githits.com/api/requests-and-responses#choose-what-the-response-includes) for details.\n\n| Selector | Data | Default |\n| --- | --- | --- |\n| `vulnerabilities.summary` | Counts, assessment status and reasons for the selected filters, with nullable affectedness for the inspected release. | Yes |\n| `vulnerabilities.advisories` | One page of advisories with applicability reasons, compact affected-version display and pagination. Up to 100 advisories per page. | Yes |\n| `vulnerabilities.upgrade_paths` | Source fix candidates evaluated against the filtered advisory corpus; not guaranteed newer or published releases. | Yes |\n| `vulnerabilities.*` | All vulnerability groups: summary, advisories, and upgrade_paths. | No |\n","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/packages/{registry}/{name}/vulnerabilities","href":"/api-reference/v1/packages/inspect-package-vulnerabilities"}]},{"group":"Code Diff","pages":[{"title":"Compare two exact source trees","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/code/diff","href":"/api-reference/v1/code-diff/compare-two-exact-source-trees"}]},{"group":"Examples","pages":[{"title":"Generate an example from open-source references","description":"Generate a code example for a programming task using open-source references. The response contains Markdown with source references, license attribution, and a link to the saved example.\n\nUse this endpoint when you want an example tailored to your task. To find existing documentation or code instead, use `POST /v1/searches`. You can rate a saved example with `POST /v1/feedback`.","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/examples/search","href":"/api-reference/v1/examples/generate-an-example-from-open-source-references"}]},{"group":"Experimental","pages":[{"title":"Compare two exact source trees","deprecated":true,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/code/diff","href":"/api-reference/v1/experimental/compare-two-exact-source-trees"},{"title":"Compare two dependency snapshots","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/dependency-diffs","href":"/api-reference/v1/experimental/compare-two-dependency-snapshots"},{"title":"Preview a compact dependency-license report","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/license-reports","href":"/api-reference/v1/experimental/preview-a-compact-dependency-license-report"},{"title":"Preview a compact report for a completed analysis","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/experimental/license-reports/{id}","href":"/api-reference/v1/experimental/preview-a-compact-report-for-a-completed-analysis"},{"title":"Report dependency licenses from uploaded files","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/licenses","href":"/api-reference/v1/experimental/report-dependency-licenses-from-uploaded-files"},{"title":"Get dependency licenses for a completed analysis","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/experimental/licenses/{id}","href":"/api-reference/v1/experimental/get-dependency-licenses-for-a-completed-analysis"},{"title":"Submit a lockfile analysis job","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/lockfile-jobs","href":"/api-reference/v1/experimental/submit-a-lockfile-analysis-job"},{"title":"Get lockfile analysis status","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/experimental/lockfile-jobs/{id}","href":"/api-reference/v1/experimental/get-lockfile-analysis-status"},{"title":"Stream lockfile analysis progress","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/experimental/lockfile-jobs/{id}/events","href":"/api-reference/v1/experimental/stream-lockfile-analysis-progress"},{"title":"Download a completed lockfile analysis","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/experimental/lockfile-jobs/{id}/result","href":"/api-reference/v1/experimental/download-a-completed-lockfile-analysis"},{"title":"Research a question with cited sources","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/research","href":"/api-reference/v1/experimental/research-a-question-with-cited-sources"},{"title":"Generate an SBOM from uploaded files","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/sbom","href":"/api-reference/v1/experimental/generate-an-sbom-from-uploaded-files"},{"title":"Resolve a target name","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/experimental/targets/resolve","href":"/api-reference/v1/experimental/resolve-a-target-name"}]},{"group":"Feedback","pages":[{"title":"Submit solution or session feedback","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/feedback","href":"/api-reference/v1/feedback/submit-solution-or-session-feedback"}]},{"group":"Grep","pages":[{"title":"Find regex or literal matches across source and documentation","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/grep","href":"/api-reference/v1/grep/find-regex-or-literal-matches-across-source-and-documentation"}]},{"group":"Languages","pages":[{"title":"Search supported programming languages","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/languages","href":"/api-reference/v1/languages/search-supported-programming-languages"}]},{"group":"List","pages":[{"title":"List files and documentation paths","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/list","href":"/api-reference/v1/list/list-files-and-documentation-paths"}]},{"group":"Read","pages":[{"title":"Read documentation or source code","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/read","href":"/api-reference/v1/read/read-documentation-or-source-code"}]},{"group":"Search","pages":[{"title":"Search documentation, code and symbols","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json post /v1/searches","href":"/api-reference/v1/search/search-documentation-code-and-symbols"},{"title":"Get search status and retained results","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/searches/{search_ref}","href":"/api-reference/v1/search/get-search-status-and-retained-results"}]},{"group":"Vulnerabilities","pages":[{"title":"Look up a vulnerability and affected packages","deprecated":null,"version":null,"openapi":"https://api.githits.dev/v1/openapi.json get /v1/vulnerabilities/{id}","href":"/api-reference/v1/vulnerabilities/look-up-a-vulnerability-and-affected-packages"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},"basePath":"","title":"Compare two exact source trees - GitHits","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-D6S0Yh6q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}