Sets default_struct_version for new documents added to this batch. Existing rows keep the version they were extracted with until you reassign or reprocess them.
Authorizations
extractApiKeybearerAuthcookieAuth
Authorization
string
header
required
Extract API key (sk-abacus-*)
Path Parameters
batch_id
integer
required
Body
application/json
Body for batch version reassignment endpoints (Task 16).
Accepts a single version_number field; the consuming view resolves it
against the parent batch's struct and rejects deprecated versions.
version_number
integer
required
Required range: x >= 1
Response
List shape for StructVersion rows (no schema body).
version_number
integer
required
Required range: 0 <= x <= 2147483647
published_at
string<date-time>
required
read-only
published_by
object | null
required
Compact projection of the user who published / deprecated a version.
Show child attributes
field_count
integer
required
read-only
is_deprecated
boolean
required
read-only
deprecated_by
object | null
required
Compact projection of the user who published / deprecated a version.
{"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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/batches/default-version","slug":"/api-reference/batches/default-version","pageMetadata":{"title":"Set a batch default schema","sidebarTitle":"Default schema","openapi":"POST /api/v2/batches/{batch_id}/default-version/","description":"Set the default published schema version for new batch documents.","href":"/api-reference/batches/default-version"},"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: \"Set the default published schema version for new batch documents.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Sets `,_jsx(_components.code,{children:`default_struct_version`}),` for `,_jsx(_components.strong,{children:`new`}),` documents added to this batch. Existing rows keep the version they were extracted with until you reassign or reprocess them.`]})}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":"Set a batch default schema","sidebarTitle":"Default schema","openapi":"POST /api/v2/batches/{batch_id}/default-version/","description":"Set the default published schema version for new batch documents.","href":"/api-reference/batches/default-version"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"v2_batches_default_version_create","description":"Set the default published schema version for new batch documents.","summary":"Reassign the default StructVersion for a batch","parameters":["6f189f93-70a5-4f75-8d21-5dbabf493673"],"tags":["v2/batches"],"requestBody":"4dea66fd-ca08-453e-82c5-f0fc8137eff2","security":["badcf0f7-8a9d-4225-a08c-566453e5d820","080b2359-6482-4b01-927b-552c82e60ac8","f740850d-f028-49f0-a6ff-3e22e3eea72d"],"responses":{"200":"29afaee5-aa50-4cb0-97a8-958d33192a02","400":"1b89930b-4fc5-44bb-9c4f-b616d84233a0","404":"fbcb0d2e-8fa2-44b8-b4de-d371aa49358a"},"method":"post","type":"path","servers":[],"path":"/api/v2/batches/{batch_id}/default-version/","baseUrlOptions":[],"title":"Reassign the default StructVersion for a batch","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6f189f93-70a5-4f75-8d21-5dbabf493673":{"in":"path","name":"batch_id","schema":{"type":"integer","isRequired":true,"uniqueKey":"","typeLabel":"integer"},"required":true}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Body for batch version reassignment endpoints (Task 16).\n\nAccepts a single ``version_number`` field; the consuming view resolves it\nagainst the parent batch's struct and rejects deprecated versions.","properties":{"version_number":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"version_number","typeLabel":"integer"}},"required":["version_number"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"version_number":2}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"29afaee5-aa50-4cb0-97a8-958d33192a02":{"content":{"application/json":{"schema":{"type":"object","description":"List shape for ``StructVersion`` rows (no schema body).","properties":{"version_number":{"type":"integer","maximum":2147483647,"minimum":0,"isRequired":true,"uniqueKey":"version_number","typeLabel":"integer"},"published_at":{"type":"string","format":"date-time","readOnly":true,"isRequired":true,"uniqueKey":"published_at","typeLabel":"string\u003cdate-time>"},"published_by":{"oneOf":[{"type":"object","description":"Compact projection of the user who published / deprecated a version.","required":["email","id"],"properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"published_by.oneOf.0.id","typeLabel":"integer"},"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"published_by.oneOf.0.email","typeLabel":"string\u003cemail>"}},"isRequired":true,"uniqueKey":"published_by.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"published_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"published_by","typeLabel":"object | null"},"field_count":{"type":"integer","readOnly":true,"isRequired":true,"uniqueKey":"field_count","typeLabel":"integer"},"is_deprecated":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"is_deprecated","typeLabel":"boolean"},"deprecated_by":{"oneOf":[{"type":"object","description":"Compact projection of the user who published / deprecated a version.","required":["email","id"],"properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"deprecated_by.oneOf.0.id","typeLabel":"integer"},"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"deprecated_by.oneOf.0.email","typeLabel":"string\u003cemail>"}},"isRequired":true,"uniqueKey":"deprecated_by.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"deprecated_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deprecated_by","typeLabel":"object | null"},"publish_note":{"type":"string","maxLength":500,"uniqueKey":"publish_note","typeLabel":"string"},"deprecated_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"deprecated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"deprecated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"deprecated_at","typeLabel":"string\u003cdate-time> | null"},"deprecation_note":{"type":"string","maxLength":500,"uniqueKey":"deprecation_note","typeLabel":"string"}},"required":["deprecated_by","field_count","is_deprecated","published_at","published_by","version_number"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"version_number":1073741823,"published_at":"2023-11-07T05:31:56Z","published_by":{"id":123,"email":"jsmith@example.com"},"field_count":123,"is_deprecated":true,"deprecated_by":{"id":123,"email":"jsmith@example.com"},"publish_note":"\u003cstring>","deprecated_at":"2023-11-07T05:31:56Z","deprecation_note":"\u003cstring>"}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"1b89930b-4fc5-44bb-9c4f-b616d84233a0":{"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"},"fbcb0d2e-8fa2-44b8-b4de-d371aa49358a":{"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":{"badcf0f7-8a9d-4225-a08c-566453e5d820":{"extractApiKey":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Extract API key (sk-abacus-*)","scopes":[],"schemeName":"extractApiKey"}},"080b2359-6482-4b01-927b-552c82e60ac8":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter your Auth0 JWT token","scopes":[],"schemeName":"bearerAuth"}},"f740850d-f028-49f0-a6ff-3e22e3eea72d":{"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":"Set a batch default schema - Abacus Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-20T18:35:33.435Z","originalFileLocation":"api-reference/batches/default-version.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=\"Set the default published schema version for new batch documents.\">\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=\"Set a batch default schema - Abacus Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Set the default published schema version for new batch documents.\">\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/batches/default-version\">\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=Batches\u0026amp;title=Set+a+batch+default+schema\u0026amp;description=Set+the+default+published+schema+version+for+new+batch+documents.\u0026amp;theme=9ad23ac21ef16a116c90afc7\u0026amp;signature=45951240b6c0d8203dc7181aa7a04c5ec8c3cfb152a5acb92603fec979383d0a\">\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=\"Set a batch default schema - Abacus Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Set the default published schema version for new batch documents.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://abacus-docs.mintlify.site/_mintlify/api/og/v2?division=Batches\u0026amp;title=Set+a+batch+default+schema\u0026amp;description=Set+the+default+published+schema+version+for+new+batch+documents.\u0026amp;theme=9ad23ac21ef16a116c90afc7\u0026amp;signature=45951240b6c0d8203dc7181aa7a04c5ec8c3cfb152a5acb92603fec979383d0a\">\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/batches/default-version\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/batches/default-version.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/batches/default-version#webpage\",\"url\":\"https://help.abacusdocs.com/api-reference/batches/default-version\",\"name\":\"Set a batch default schema\",\"description\":\"Set the default published schema version for new batch documents.\",\"dateModified\":\"2026-09-20T18:35:33.435Z\",\"isPartOf\":{\"@id\":\"https://help.abacusdocs.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.abacusdocs.com/api-reference/batches/default-version#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.abacusdocs.com/api-reference/batches/default-version#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Batches\",\"item\":\"https://help.abacusdocs.com/api-reference/batches/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Set a batch default schema\",\"item\":\"https://help.abacusdocs.com/api-reference/batches/default-version\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.abacusdocs.com/api-reference/batches/default-version#apireference\",\"headline\":\"Set a batch default schema\",\"name\":\"Set a batch default schema\",\"description\":\"Set the default published schema version for new batch documents.\",\"url\":\"https://help.abacusdocs.com/api-reference/batches/default-version\",\"mainEntityOfPage\":{\"@id\":\"https://help.abacusdocs.com/api-reference/batches/default-version#webpage\"},\"dateModified\":\"2026-09-20T18:35:33.435Z\",\"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/batches/default-version.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/","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}/","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/","description":"Export a batch extraction grid as 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/","description":"Pin a published schema version onto one batch document.","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":"Set a batch default 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"]}