Draft versus last published version. Used by the builder before publish. Not billed.
Authorizations
extractApiKeybearerAuthcookieAuth
Authorization
string
header
required
Extract API key (sk-abacus-*)
Path Parameters
slug
string
required
Query Parameters
from
string
required
Diff source — either a published version number (integer >= 1) or the literal draft.
to
string
required
Diff target — either a published version number (integer >= 1) or the literal draft.
Response
Response shape for GET /structs/{slug}/diff/?from=&to=.
Compares two endpoints (each is a published version number or the
literal "draft") and returns added / removed / modified / reordered field
sets plus the full JSON bodies for client-side rendering.
diff_from
object
required
Compact {version, label} block describing one side of a diff.
Show child attributes
diff_to
object
required
Compact {version, label} block describing one side of a diff.
Show child attributes
added_fields
object[]
required
Show child attributes
removed_fields
object[]
required
Show child attributes
modified_fields
object[]
required
Show child attributes
reordered_field_ids
string[]
required
annotation_changes
any[]
required
from_schema_json
any
required
to_schema_json
any
required
⌘I
Diff two Struct versions (or a version against the draft)
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Abacus Docs","colors":{"primary":"#040404"},"logo":{"light":"https://abacusdocs.com/static/abacus-black.png","dark":"https://abacusdocs.com/static/abacus-white.png","href":"https://abacusdocs.com"},"favicon":"https://abacusdocs.com/static/documents/images/abacus-white.png","api":{"openapi":"https://gist.githubusercontent.com/MoHayat/4b48b87f8182c8e0dc85741b402ce034/raw/abacus-docs-openapi.yml","playground":{"display":"interactive","proxy":true},"examples":{"languages":["curl","python","javascript"]}},"navbar":{"links":[{"href":"https://abacusdocs.com/contact","label":"Contact"}],"primary":{"type":"button","label":"Sign In","href":"https://abacusdocs.com/auth/login"}},"footer":{"links":[{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://abacusdocs.com/privacy"},{"label":"Terms of Service","href":"https://abacusdocs.com/terms"}]},{"header":"Support","items":[{"label":"Contact Us","href":"https://abacusdocs.com/contact"}]}]},"seo":{"metatags":{"canonical":"https://help.abacusdocs.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"abacus-docs","hasAudioNarration":false,"actualSubdomain":"abacus-docs","customDomains":["help.abacusdocs.com"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-abacus-docs-7e325004","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad20b742c87cf377d1352b2","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":75},{"language":"default","tag":"Documents","count":25},{"language":"default","tag":"Documentation","count":23},{"language":"default","tag":"Schemas","count":17},{"language":"default","tag":"Sharing","count":13},{"language":"default","tag":"Chat-id routes","count":12},{"language":"default","tag":"Batches","count":10},{"language":"default","tag":"Ingest","count":9},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Notifications","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/schemas/diff","slug":"/api-reference/schemas/diff","pageMetadata":{"title":"Diff a schema","sidebarTitle":"Diff","openapi":"GET /api/v2/structs/{slug}/diff/","description":"Diff the working draft against the last published version.","href":"/api-reference/schemas/diff"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Diff the working draft against the last published version.\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Draft versus last published version. Used by the builder before publish. Not billed.`})}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":"Diff a schema","sidebarTitle":"Diff","openapi":"GET /api/v2/structs/{slug}/diff/","description":"Diff the working draft against the last published version.","href":"/api-reference/schemas/diff"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"v2_structs_diff_retrieve","description":"Diff the working draft against the last published version.","summary":"Diff two Struct versions (or a version against the draft)","parameters":["7dfcc533-6bff-4f55-8c73-fe9389478f81","3bec45ab-e1fe-46e5-b7bd-33945293fefa","bf713b6a-7bfe-4d60-a252-8ca1b7fb0da9"],"tags":["v2/structs"],"security":["648d5e20-577f-4ad6-87ab-1ed884fc5530","29ff414c-c9d7-4b0d-860f-df5ccb900661","65a4ae63-03e3-46f1-a2a9-e67c5cda8e0c"],"responses":{"200":"42f41c7a-ec6b-45da-9897-dbf6738cc2a7","400":"056ec15b-e4d0-403b-afa4-afd089d722d5","404":"89f91aaa-290a-4d60-bc48-129f6441e344"},"method":"get","type":"path","servers":[],"path":"/api/v2/structs/{slug}/diff/","baseUrlOptions":[],"title":"Diff two Struct versions (or a version against the draft)","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7dfcc533-6bff-4f55-8c73-fe9389478f81":{"in":"query","name":"from","schema":{"type":"string","isRequired":true,"description":"Diff source — either a published version number (integer >= 1) or the literal ``draft``.","uniqueKey":"","typeLabel":"string"},"description":"Diff source — either a published version number (integer >= 1) or the literal ``draft``.","required":true},"3bec45ab-e1fe-46e5-b7bd-33945293fefa":{"in":"path","name":"slug","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true},"bf713b6a-7bfe-4d60-a252-8ca1b7fb0da9":{"in":"query","name":"to","schema":{"type":"string","isRequired":true,"description":"Diff target — either a published version number (integer >= 1) or the literal ``draft``.","uniqueKey":"","typeLabel":"string"},"description":"Diff target — either a published version number (integer >= 1) or the literal ``draft``.","required":true}},"responses":{"42f41c7a-ec6b-45da-9897-dbf6738cc2a7":{"content":{"application/json":{"schema":{"type":"object","description":"Response shape for GET /structs/{slug}/diff/?from=\u0026to=.\n\nCompares two endpoints (each is a published version number or the\nliteral \"draft\") and returns added / removed / modified / reordered field\nsets plus the full JSON bodies for client-side rendering.","properties":{"diff_from":{"type":"object","description":"Compact ``{version, label}`` block describing one side of a diff.","properties":{"version":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"diff_from.version.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"diff_from.version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"diff_from.version","typeLabel":"integer | null"},"label":{"type":"string","isRequired":true,"uniqueKey":"diff_from.label","typeLabel":"string"}},"required":["label","version"],"isRequired":true,"uniqueKey":"diff_from","typeLabel":"object"},"diff_to":{"type":"object","description":"Compact ``{version, label}`` block describing one side of a diff.","properties":{"version":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"diff_to.version.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"diff_to.version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"diff_to.version","typeLabel":"integer | null"},"label":{"type":"string","isRequired":true,"uniqueKey":"diff_to.label","typeLabel":"string"}},"required":["label","version"],"isRequired":true,"uniqueKey":"diff_to","typeLabel":"object"},"added_fields":{"type":"array","items":{"type":"object","description":"Loose projection of a SchemaField from ExtractionSchema JSON.\n\nKept as a permissive serializer (not a hard schema) because the schema\nbuilder is still iterating on field shapes — drf-spectacular only needs\na stable component name for the SPA codegen, not full type fidelity.","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"added_fields.items.[INDEX].id","typeLabel":"string"},"label":{"type":"string","uniqueKey":"added_fields.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","uniqueKey":"added_fields.items.[INDEX].type","typeLabel":"string"}},"required":["id"],"uniqueKey":"added_fields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"added_fields","typeLabel":"object[]"},"removed_fields":{"type":"array","items":{"type":"object","description":"Loose projection of a SchemaField from ExtractionSchema JSON.\n\nKept as a permissive serializer (not a hard schema) because the schema\nbuilder is still iterating on field shapes — drf-spectacular only needs\na stable component name for the SPA codegen, not full type fidelity.","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"removed_fields.items.[INDEX].id","typeLabel":"string"},"label":{"type":"string","uniqueKey":"removed_fields.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","uniqueKey":"removed_fields.items.[INDEX].type","typeLabel":"string"}},"required":["id"],"uniqueKey":"removed_fields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"removed_fields","typeLabel":"object[]"},"modified_fields":{"type":"array","items":{"type":"object","description":"Per-field diff descriptor for the diff endpoint.","properties":{"field_id":{"type":"string","isRequired":true,"uniqueKey":"modified_fields.items.[INDEX].field_id","typeLabel":"string"},"before":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"modified_fields.items.[INDEX].before.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"modified_fields.items.[INDEX].before","typeLabel":"null"},"after":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"modified_fields.items.[INDEX].after.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"modified_fields.items.[INDEX].after","typeLabel":"null"},"position_changed":{"type":"boolean","isRequired":true,"uniqueKey":"modified_fields.items.[INDEX].position_changed","typeLabel":"boolean"}},"required":["after","before","field_id","position_changed"],"uniqueKey":"modified_fields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"modified_fields","typeLabel":"object[]"},"reordered_field_ids":{"type":"array","items":{"type":"string","uniqueKey":"reordered_field_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"reordered_field_ids","typeLabel":"string[]"},"annotation_changes":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"annotation_changes.items.[INDEX]","typeLabel":"any"},"isRequired":true,"uniqueKey":"annotation_changes","typeLabel":"any[]"},"from_schema_json":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"from_schema_json","typeLabel":"any"},"to_schema_json":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"to_schema_json","typeLabel":"any"}},"required":["added_fields","annotation_changes","diff_from","diff_to","from_schema_json","modified_fields","removed_fields","reordered_field_ids","to_schema_json"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"diff_from":{"version":123,"label":"\u003cstring>"},"diff_to":{"version":123,"label":"\u003cstring>"},"added_fields":[{"id":"\u003cstring>","label":"\u003cstring>","type":"\u003cstring>"}],"removed_fields":[{"id":"\u003cstring>","label":"\u003cstring>","type":"\u003cstring>"}],"modified_fields":[{"field_id":"\u003cstring>","before":"\u003cunknown>","after":"\u003cunknown>","position_changed":true}],"reordered_field_ids":["\u003cstring>"],"annotation_changes":["\u003cunknown>"],"from_schema_json":"\u003cunknown>","to_schema_json":"\u003cunknown>"}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"056ec15b-e4d0-403b-afa4-afd089d722d5":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"89f91aaa-290a-4d60-bc48-129f6441e344":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"description":"","exampleType":"generated"}},"security":{"648d5e20-577f-4ad6-87ab-1ed884fc5530":{"extractApiKey":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Extract API key (sk-abacus-*)","scopes":[],"schemeName":"extractApiKey"}},"29ff414c-c9d7-4b0d-860f-df5ccb900661":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter your Auth0 JWT token","scopes":[],"schemeName":"bearerAuth"}},"65a4ae63-03e3-46f1-a2a9-e67c5cda8e0c":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid","scopes":[],"schemeName":"cookieAuth"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Extract API key (sk-abacus-*)","scopes":[],"schemeName":"extractApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Extract API key (sk-abacus-*)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"extractApiKey","name":"Authorization"}],"title":"extractApiKey"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter your Auth0 JWT token","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Enter your Auth0 JWT token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"cookie","name":"sessionid","scopes":[],"schemeName":"cookieAuth"},"schema":{"title":"sessionid","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"cookieAuth","name":"sessionid"}],"title":"cookieAuth"}]},"originalFileLocation":"https://gist.githubusercontent.com/MoHayat/4b48b87f8182c8e0dc85741b402ce034/raw/abacus-docs-openapi.yml"},"subdomain":"abacus-docs","siteName":"Abacus Docs","title":"Diff a schema - Abacus Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-20T18:35:26.710Z","originalFileLocation":"api-reference/schemas/diff.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Diff the working draft against the last published version.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Abacus Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://abacusdocs.com/static/documents/images/abacus-white.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://abacusdocs.com/static/documents/images/abacus-white.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://abacusdocs.com/static/documents/images/abacus-white.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://abacusdocs.com/static/documents/images/abacus-white.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Diff a schema - Abacus Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Diff the working draft against the last published version.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Abacus Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.abacusdocs.com/api-reference/schemas/diff\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://abacus-docs.mintlify.site/_mintlify/api/og/v2?division=Schemas\u0026amp;title=Diff+a+schema\u0026amp;description=Diff+the+working+draft+against+the+last+published+version.\u0026amp;theme=9ad23ac21ef16a116c90afc7\u0026amp;signature=27bed58575ba55ec01a926db93ab14e8ff2e9e0278ba6ba444ea2e572a846d8c\">\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=\"Diff a schema - Abacus Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Diff the working draft against the last published version.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://abacus-docs.mintlify.site/_mintlify/api/og/v2?division=Schemas\u0026amp;title=Diff+a+schema\u0026amp;description=Diff+the+working+draft+against+the+last+published+version.\u0026amp;theme=9ad23ac21ef16a116c90afc7\u0026amp;signature=27bed58575ba55ec01a926db93ab14e8ff2e9e0278ba6ba444ea2e572a846d8c\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/abacus-docs/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Abacus Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#040404\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.abacusdocs.com/api-reference/schemas/diff\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/schemas/diff.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.abacusdocs.com/#organization\",\"name\":\"Abacus Docs\",\"url\":\"https://help.abacusdocs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://abacusdocs.com/static/abacus-black.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.abacusdocs.com#website\",\"name\":\"Abacus Docs\",\"url\":\"https://help.abacusdocs.com\",\"publisher\":{\"@id\":\"https://help.abacusdocs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.abacusdocs.com/api-reference/schemas/diff#webpage\",\"url\":\"https://help.abacusdocs.com/api-reference/schemas/diff\",\"name\":\"Diff a schema\",\"description\":\"Diff the working draft against the last published version.\",\"dateModified\":\"2026-09-20T18:35:26.710Z\",\"isPartOf\":{\"@id\":\"https://help.abacusdocs.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.abacusdocs.com/api-reference/schemas/diff#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.abacusdocs.com/api-reference/schemas/diff#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Schemas\",\"item\":\"https://help.abacusdocs.com/api-reference/schemas/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Diff a schema\",\"item\":\"https://help.abacusdocs.com/api-reference/schemas/diff\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.abacusdocs.com/api-reference/schemas/diff#apireference\",\"headline\":\"Diff a schema\",\"name\":\"Diff a schema\",\"description\":\"Diff the working draft against the last published version.\",\"url\":\"https://help.abacusdocs.com/api-reference/schemas/diff\",\"mainEntityOfPage\":{\"@id\":\"https://help.abacusdocs.com/api-reference/schemas/diff#webpage\"},\"dateModified\":\"2026-09-20T18:35:26.710Z\",\"publisher\":{\"@id\":\"https://help.abacusdocs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.abacusdocs.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Abacus Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Abacus Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/schemas/diff.md","siteName":"Abacus Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Abacus Docs API","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"Abacus Docs API Authentication Guide and Key Management","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Abacus Docs API Error Codes, HTTP Statuses and Handling","sidebarTitle":"Errors","href":"/api-reference/errors"},{"title":"Get current user","sidebarTitle":"Get current user","openapi":"GET /api/v2/me/","href":"/api-reference/me"}]},{"group":"Documents","pages":[{"title":"List documents","sidebarTitle":"List documents","openapi":"GET /api/v2/documents/attachments/","href":"/api-reference/documents/list-attachments"},{"title":"Get a document","sidebarTitle":"Get a document","openapi":"GET /api/v2/documents/attachments/{att_id}/","href":"/api-reference/documents/get-attachment"},{"title":"Edit document metadata","sidebarTitle":"Rename","openapi":"PATCH /api/v2/documents/attachments/{att_id}/","href":"/api-reference/documents/patch-attachment"},{"title":"Edit an extraction cell","sidebarTitle":"Edit a cell","openapi":"PATCH /api/v2/documents/attachments/{att_id}/extraction/cells/{field_id}/","href":"/api-reference/documents/edit-cell"},{"title":"Download the file","sidebarTitle":"File","openapi":"GET /api/v2/documents/attachments/{att_id}/file/","href":"/api-reference/documents/attachment-file"},{"title":"Rendered markdown","sidebarTitle":"Markdown","openapi":"GET /api/v2/documents/attachments/{att_id}/markdown/","href":"/api-reference/documents/attachment-markdown"},{"title":"Move to another batch","sidebarTitle":"Move batch","openapi":"POST /api/v2/documents/attachments/{att_id}/move-batch/","href":"/api-reference/documents/move-batch"},{"title":"Reprocess a document","sidebarTitle":"Reprocess","openapi":"POST /api/v2/documents/attachments/{att_id}/reprocess/","href":"/api-reference/documents/reprocess"},{"title":"Sections","sidebarTitle":"Sections","openapi":"GET /api/v2/documents/attachments/{att_id}/sections/","href":"/api-reference/documents/attachment-sections"},{"title":"Processing progress (SSE)","sidebarTitle":"Progress stream","openapi":"GET /api/v2/documents/attachments/{att_id}/stream/","href":"/api-reference/documents/attachment-stream"},{"group":"Chat-id routes","pages":[{"title":"List documents (chat id)","sidebarTitle":"List","openapi":"GET /api/v2/documents/","href":"/api-reference/documents/list-chats"},{"title":"Upload documents (chat id)","sidebarTitle":"Upload","openapi":"POST /api/v2/documents/","href":"/api-reference/documents/upload-chat"},{"title":"Get document (chat id)","sidebarTitle":"Get","openapi":"GET /api/v2/documents/{id}/","href":"/api-reference/documents/get-chat"},{"title":"Delete document (chat id)","sidebarTitle":"Delete","openapi":"DELETE /api/v2/documents/{id}/","href":"/api-reference/documents/delete-chat"},{"title":"Retry a chat-id document","sidebarTitle":"Retry","openapi":"POST /api/v2/documents/{id}/retry/","href":"/api-reference/documents/retry-chat"},{"title":"Chat-id file bytes","sidebarTitle":"File","openapi":"GET /api/v2/documents/{id}/file/","href":"/api-reference/documents/chat-file"},{"title":"Chat-id progress","sidebarTitle":"Progress","openapi":"GET /api/v2/documents/{id}/progress/","href":"/api-reference/documents/chat-progress"},{"title":"Chat-id sections","sidebarTitle":"Sections","openapi":"GET /api/v2/documents/{id}/sections/","href":"/api-reference/documents/chat-sections"},{"title":"Chat-id events","sidebarTitle":"Events","openapi":"POST /api/v2/documents/{id}/events/","href":"/api-reference/documents/chat-events"},{"title":"List document share links","sidebarTitle":"Share links","openapi":"GET /api/v2/documents/{id}/share-links/","href":"/api-reference/documents/list-share-links"},{"title":"Issue a document share link","sidebarTitle":"Issue share link","openapi":"POST /api/v2/documents/{id}/share-links/","href":"/api-reference/documents/create-share-link"},{"title":"Revoke a document share link","sidebarTitle":"Revoke share link","openapi":"DELETE /api/v2/documents/{id}/share-links/{link_id}/","href":"/api-reference/documents/revoke-share-link"}]}]},{"group":"Schemas","pages":[{"title":"List schemas","sidebarTitle":"List schemas","openapi":"GET /api/v2/structs/","href":"/api-reference/schemas/list"},{"title":"Create a schema","sidebarTitle":"Create","openapi":"POST /api/v2/structs/","href":"/api-reference/schemas/create"},{"title":"Publish a schema","sidebarTitle":"Publish","openapi":"POST /api/v2/structs/{slug}/publish/","href":"/api-reference/schemas/publish"},{"title":"Get a schema","sidebarTitle":"Get","openapi":"GET /api/v2/structs/{slug}/","href":"/api-reference/schemas/get"},{"title":"Update a schema draft","sidebarTitle":"Update draft","openapi":"PATCH /api/v2/structs/{slug}/","href":"/api-reference/schemas/update"},{"title":"List schema versions","sidebarTitle":"Versions","openapi":"GET /api/v2/structs/{slug}/versions/","href":"/api-reference/schemas/versions"},{"title":"Delete a schema","sidebarTitle":"Delete","openapi":"DELETE /api/v2/structs/{slug}/","href":"/api-reference/schemas/delete"},{"title":"Copy a schema","sidebarTitle":"Copy","openapi":"POST /api/v2/structs/{slug}/copy/","description":"Clone a schema's current published version.","href":"/api-reference/schemas/copy"},{"title":"Diff a schema","sidebarTitle":"Diff","openapi":"GET /api/v2/structs/{slug}/diff/","href":"/api-reference/schemas/diff"},{"title":"Restore a schema version","sidebarTitle":"Restore","openapi":"POST /api/v2/structs/{slug}/restore/{version_number}/","description":"Restore a published version into the working draft.","href":"/api-reference/schemas/restore"},{"title":"Get a schema version","sidebarTitle":"Get version","openapi":"GET /api/v2/structs/{slug}/versions/{version_number}/","href":"/api-reference/schemas/get-version"},{"title":"Deprecate a schema version","sidebarTitle":"Deprecate","openapi":"POST /api/v2/structs/{slug}/versions/{version_number}/deprecate/","href":"/api-reference/schemas/deprecate"},{"title":"Undeprecate a schema version","sidebarTitle":"Undeprecate","openapi":"POST /api/v2/structs/{slug}/versions/{version_number}/undeprecate/","href":"/api-reference/schemas/undeprecate"}]},{"group":"Batches","pages":[{"title":"List batches","sidebarTitle":"List batches","openapi":"GET /api/v2/batches/","href":"/api-reference/batches/list"},{"title":"Cancel batch documents","sidebarTitle":"Cancel","openapi":"POST /api/v2/batches/{batch_id}/cancel/","href":"/api-reference/batches/cancel"},{"title":"Upload and add files","sidebarTitle":"Upload and add","openapi":"POST /api/v2/batches/{batch_id}/upload-and-add/","href":"/api-reference/batches/upload-and-add"},{"title":"Reprocess batch documents","sidebarTitle":"Reprocess","openapi":"POST /api/v2/batches/{batch_id}/reprocess/","href":"/api-reference/batches/reprocess"},{"title":"Add library documents to a batch","sidebarTitle":"Add documents","openapi":"POST /api/v2/batches/{batch_id}/documents/","href":"/api-reference/batches/add-documents"},{"title":"Edit a batch cell","sidebarTitle":"Edit a cell","openapi":"PATCH /api/v2/batches/{batch_id}/documents/{doc_id}/cells/","href":"/api-reference/batches/edit-cell"},{"title":"Export batch JSON","sidebarTitle":"Export JSON","openapi":"GET /api/v2/batches/{batch_id}/export.json/","href":"/api-reference/batches/export-json"},{"title":"Set a batch default schema","sidebarTitle":"Default schema","openapi":"POST /api/v2/batches/{batch_id}/default-version/","href":"/api-reference/batches/default-version"},{"title":"Reassign a document schema","sidebarTitle":"Reassign schema","openapi":"POST /api/v2/batches/{batch_id}/documents/{doc_id}/version/","href":"/api-reference/batches/reassign-version"},{"title":"Resume a batch","sidebarTitle":"Resume","openapi":"POST /api/v2/batches/{batch_id}/resume/","href":"/api-reference/batches/resume"}]},{"group":"Notifications","pages":[{"title":"List notifications","sidebarTitle":"List","openapi":"GET /api/v2/notifications/","href":"/api-reference/notifications/list"},{"title":"Mark a notification read","sidebarTitle":"Mark read","openapi":"POST /api/v2/notifications/{id}/mark-read/","href":"/api-reference/notifications/mark-read"},{"title":"Mark all notifications read","sidebarTitle":"Mark all read","openapi":"POST /api/v2/notifications/mark-all-read/","href":"/api-reference/notifications/mark-all-read"},{"title":"Unread notification count","sidebarTitle":"Unread count","openapi":"GET /api/v2/notifications/unread-count/","href":"/api-reference/notifications/unread-count"}]},{"group":"Ingest","pages":[{"title":"Register an ingest agent","sidebarTitle":"Register agent","openapi":"POST /api/v2/ingest/agents/","href":"/api-reference/ingest/register-agent"},{"title":"Ingest items feed","sidebarTitle":"Items feed","openapi":"GET /api/v2/ingest/items/","href":"/api-reference/ingest/items"},{"title":"Start an ingest upload","sidebarTitle":"Start upload","openapi":"POST /api/v2/ingest/uploads/","href":"/api-reference/ingest/start-upload"},{"title":"Complete an ingest upload","sidebarTitle":"Complete upload","openapi":"POST /api/v2/ingest/uploads/{item_id}/complete/","href":"/api-reference/ingest/complete-upload"},{"title":"Ingest schemas","sidebarTitle":"Schemas","openapi":"GET /api/v2/ingest/schemas/","href":"/api-reference/ingest/schemas"},{"title":"Match an ingest item","sidebarTitle":"Match","openapi":"POST /api/v2/ingest/items/{item_id}/match/","href":"/api-reference/ingest/match-item"},{"title":"Auto-match ingest items","sidebarTitle":"Auto-match","openapi":"POST /api/v2/ingest/items/auto-match/","href":"/api-reference/ingest/auto-match"},{"title":"Process ingest items","sidebarTitle":"Process","openapi":"POST /api/v2/ingest/items/process/","href":"/api-reference/ingest/process-items"},{"title":"Latest ingest batch","sidebarTitle":"Latest batch","openapi":"GET /api/v2/ingest/schemas/{slug}/batches/latest/","href":"/api-reference/ingest/latest-batch"}]},{"group":"Sharing","pages":[{"title":"List org-library shares","sidebarTitle":"Library shares","openapi":"GET /api/v2/library/shares/","href":"/api-reference/sharing/list-shares"},{"title":"Issue a direct-share link","sidebarTitle":"Issue link","openapi":"POST /api/v2/library/share/links/","href":"/api-reference/sharing/create-link"},{"title":"Approve a library share","sidebarTitle":"Approve","openapi":"POST /api/v2/library/shares/{id}/approve/","href":"/api-reference/sharing/approve-share"},{"title":"Reject a library share","sidebarTitle":"Reject","openapi":"POST /api/v2/library/shares/{id}/reject/","href":"/api-reference/sharing/reject-share"},{"title":"Revoke a library share","sidebarTitle":"Revoke share","openapi":"POST /api/v2/library/shares/{id}/revoke/","href":"/api-reference/sharing/revoke-share"},{"title":"Kick a library share","sidebarTitle":"Kick","openapi":"POST /api/v2/library/shares/{id}/kick/","href":"/api-reference/sharing/kick-share"},{"title":"Pending share count","sidebarTitle":"Pending count","openapi":"GET /api/v2/library/shares/pending-count/","href":"/api-reference/sharing/pending-count"},{"title":"List direct-share links","sidebarTitle":"List links","openapi":"GET /api/v2/library/share/links/","href":"/api-reference/sharing/list-links"},{"title":"Revoke a direct-share link","sidebarTitle":"Revoke link","openapi":"POST /api/v2/library/share/links/{id}/revoke/","href":"/api-reference/sharing/revoke-link"},{"title":"Accept a direct-share link","sidebarTitle":"Accept","openapi":"POST /api/v2/library/share/links/by-token/{token}/accept/","href":"/api-reference/sharing/accept-link"},{"title":"Decline a direct-share link","sidebarTitle":"Decline","openapi":"POST /api/v2/library/share/links/by-token/{token}/decline/","href":"/api-reference/sharing/decline-link"},{"title":"Request a library share","sidebarTitle":"Request share","openapi":"POST /api/v2/library/shares/","href":"/api-reference/sharing/request-share"},{"title":"Remove a direct-share acceptance","sidebarTitle":"Remove acceptance","openapi":"POST /api/v2/library/share/acceptances/{id}/remove/","href":"/api-reference/sharing/remove-acceptance"}]}]}]},"basePath":"","title":"Diff a schema - Abacus Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CnLhKuUV.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}