Multipart upload into an existing batch, then enqueue extraction. Completing those files is a batch page charge. Same 64 MB / format rules as the library.
Authorizations
extractApiKeybearerAuthcookieAuth
Authorization
string
header
required
Extract API key (sk-abacus-*)
Path Parameters
batch_id
integer
required
Body
multipart/form-data
{key}
any
Response
Response shape for POST /api/v2/batches/{batch_id}/upload-and-add/.
Combines two skip arrays:
skipped — docs that uploaded successfully but couldn't attach to
the batch (already in batch, etc.). Empty in the common path.
upload_skipped — files rejected before upload (wrong type, too
large). Lets the SPA surface partial-upload feedback inline without
a separate error toast.
added
object[]
required
Show child attributes
skipped
object[]
required
Show child attributes
upload_skipped
object[]
required
Show child attributes
⌘I
Upload new files and attach them to a batch in one round trip
{"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/upload-and-add","slug":"/api-reference/batches/upload-and-add","pageMetadata":{"title":"Upload and add files","sidebarTitle":"Upload and add","openapi":"POST /api/v2/batches/{batch_id}/upload-and-add/","description":"Upload files into an existing batch and extract.","href":"/api-reference/batches/upload-and-add"},"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: \"Upload files into an existing batch and extract.\"\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={p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Multipart upload into an existing batch, then enqueue extraction. Completing those files is a `,_jsx(_components.strong,{children:`batch page charge`}),`. Same 64 MB / format rules as the library.`]})}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":"Upload and add files","sidebarTitle":"Upload and add","openapi":"POST /api/v2/batches/{batch_id}/upload-and-add/","description":"Upload files into an existing batch and extract.","href":"/api-reference/batches/upload-and-add"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"v2_batches_upload_and_add_create","description":"Upload files into an existing batch and extract.","summary":"Upload new files and attach them to a batch in one round trip","parameters":["295c2700-622d-40ad-a524-129bfedfdc60"],"tags":["v2/batches"],"requestBody":"d5a945d6-65ff-4834-9ceb-225921833474","security":["2f23de64-8d90-4eac-861b-9913bd76e000","5c451420-9a83-4f10-a24e-0dd28e3f31b0","b670e5cf-39e5-4cc9-a436-6ad567bfd6b1"],"responses":{"201":"1f8f27a4-ac45-41aa-8601-a8abc00c79a5","400":"94aedfab-458e-4497-9e5f-b12aea297b7c","402":"5751cdb5-1a0a-47ef-8a4a-a081346b9575","404":"0f8a3c30-7204-4b35-ad8f-5efd961efd1f"},"method":"post","type":"path","servers":[],"path":"/api/v2/batches/{batch_id}/upload-and-add/","baseUrlOptions":[],"title":"Upload new files and attach them to a batch in one round trip","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"295c2700-622d-40ad-a524-129bfedfdc60":{"in":"path","name":"batch_id","schema":{"type":"integer","isRequired":true,"uniqueKey":"","typeLabel":"integer"},"required":true}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1f8f27a4-ac45-41aa-8601-a8abc00c79a5":{"content":{"application/json":{"schema":{"type":"object","description":"Response shape for POST /api/v2/batches/{batch_id}/upload-and-add/.\n\nCombines two skip arrays:\n- ``skipped`` — docs that uploaded successfully but couldn't attach to\n the batch (already in batch, etc.). Empty in the common path.\n- ``upload_skipped`` — files rejected before upload (wrong type, too\n large). Lets the SPA surface partial-upload feedback inline without\n a separate error toast.","properties":{"added":{"type":"array","items":{"type":"object","description":"Compact per-doc projection for the add-documents response.\n\nMirrors the relevant slice of ``BatchDocument`` plus the\n``StructVersion.version_number`` so the SPA can render the row without a\nfollow-up GET.\n\nThe three ``*_field_count`` / ``extraction_status`` fields surface\nextraction quality so abacus-spa renders the same colored status chip\n+ \"Show problems only\" filter that the legacy HTML grid does (Task 3 of\nthe extraction-failure-surfacing plan). They are ``None`` / ``0`` for\nfreshly-added docs (PENDING — the worker hasn't classified them yet)\nand populated for COMPLETED docs whose ``ChatAttachment.extraction_result``\nhas been written.","properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"added.items.[INDEX].id","typeLabel":"integer"},"document_id":{"type":"integer","description":"ChatAttachment.pk for the library doc backing this row.","isRequired":true,"uniqueKey":"added.items.[INDEX].document_id","typeLabel":"integer"},"original_filename":{"type":"string","isRequired":true,"uniqueKey":"added.items.[INDEX].original_filename","typeLabel":"string"},"status":{"type":"string","isRequired":true,"uniqueKey":"added.items.[INDEX].status","typeLabel":"string"},"processing_order":{"type":"integer","isRequired":true,"uniqueKey":"added.items.[INDEX].processing_order","typeLabel":"integer"},"version_number":{"oneOf":[{"type":"integer","description":"The pinned StructVersion.version_number for this doc's extraction.","isRequired":true,"uniqueKey":"added.items.[INDEX].version_number.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The pinned StructVersion.version_number for this doc's extraction.","isRequired":true,"uniqueKey":"added.items.[INDEX].version_number.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"added.items.[INDEX].version_number","typeLabel":"integer | null"},"extraction_status":{"oneOf":[{"type":"string","description":"Mirrors ``lynx_core.attachments.schema.ExtractionStatus`` — one of ``success`` / ``partial`` / ``schema_mismatch`` / ``ocr_failed``. ``null`` for PENDING / PROCESSING docs whose extraction has not produced a payload yet (clients fall back to ``status`` for the lifecycle pill in that case).","uniqueKey":"added.items.[INDEX].extraction_status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Mirrors ``lynx_core.attachments.schema.ExtractionStatus`` — one of ``success`` / ``partial`` / ``schema_mismatch`` / ``ocr_failed``. ``null`` for PENDING / PROCESSING docs whose extraction has not produced a payload yet (clients fall back to ``status`` for the lifecycle pill in that case).","uniqueKey":"added.items.[INDEX].extraction_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"added.items.[INDEX].extraction_status","typeLabel":"string | null"},"extracted_field_count":{"type":"integer","minimum":0,"description":"Number of populated fields in the doc's ``ChatAttachment.extraction_result.fields``. ``0`` for PENDING / PROCESSING docs.","uniqueKey":"added.items.[INDEX].extracted_field_count","typeLabel":"integer"},"expected_field_count":{"oneOf":[{"type":"integer","minimum":0,"description":"Number of fields declared by the doc's pinned ``StructVersion.schema_json.fields``. ``null`` for transcription-only docs (no schema attached).","uniqueKey":"added.items.[INDEX].expected_field_count.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"Number of fields declared by the doc's pinned ``StructVersion.schema_json.fields``. ``null`` for transcription-only docs (no schema attached).","uniqueKey":"added.items.[INDEX].expected_field_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"added.items.[INDEX].expected_field_count","typeLabel":"integer | null"},"extraction_message":{"type":"string","description":"Why ``extraction_status`` is not ``success``, in human-readable form, or empty. Derived when the row is read, so it names the current explanation (for example, the extraction service could not run the schema, or text recognition failed on some pages).","uniqueKey":"added.items.[INDEX].extraction_message","typeLabel":"string"}},"required":["document_id","id","original_filename","processing_order","status","version_number"],"uniqueKey":"added.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"added","typeLabel":"object[]"},"skipped":{"type":"array","items":{"type":"object","description":"Per-doc skip record for the add-documents response.\n\nSurfaced inline (no failure) so the SPA can render a partial-success\ntoast: \"Added 3 docs, skipped 2 (1 not owned, 1 already in batch)\".\n\nPossible ``reason`` values:\n- ``\"already in batch\"`` — the doc is already attached to this batch.\n- ``\"already in another batch\"`` — the doc is attached to a different\n batch. ``ChatAttachment.extraction_result`` is singular, so a doc\n cannot live in two batches simultaneously.\n- ``\"not found or not owned\"`` — the doc id doesn't belong to the\n requesting user (or the underlying chat is soft-deleted).\n- ``\"duplicate content\"`` — another attachment with the same SHA-256\n bytes is already in this batch (AD-421). ``duplicate_of`` is the\n existing ``BatchDocument.pk`` so the grid can flash that row.","properties":{"document_id":{"type":"integer","isRequired":true,"uniqueKey":"skipped.items.[INDEX].document_id","typeLabel":"integer"},"reason":{"type":"string","isRequired":true,"uniqueKey":"skipped.items.[INDEX].reason","typeLabel":"string"},"duplicate_of":{"oneOf":[{"type":"integer","description":"BatchDocument pk of the existing row when reason is duplicate content.","uniqueKey":"skipped.items.[INDEX].duplicate_of.oneOf.0","typeLabel":"integer"},{"type":"null","description":"BatchDocument pk of the existing row when reason is duplicate content.","uniqueKey":"skipped.items.[INDEX].duplicate_of.oneOf.1","typeLabel":"null"}],"uniqueKey":"skipped.items.[INDEX].duplicate_of","typeLabel":"integer | null"}},"required":["document_id","reason"],"uniqueKey":"skipped.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"skipped","typeLabel":"object[]"},"upload_skipped":{"type":"array","items":{"type":"object","description":"Per-file skip record for the upload-and-add response.\n\nDistinct from ``BatchAddDocumentsSkippedSerializer`` — this one keys\non the user-supplied ``name`` (filename) rather than a server-side\ndocument id, because the upload-and-add path skips files *before*\nthey're persisted (file rejected for size/type → never assigned an id).\n\n``duplicate_content`` / ``duplicate_content_in_request`` reasons carry\noptional ``duplicate_of`` (existing ``BatchDocument.pk``) for UI flash.","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"upload_skipped.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"upload_skipped.items.[INDEX].reason","typeLabel":"string"},"duplicate_of":{"oneOf":[{"type":"integer","uniqueKey":"upload_skipped.items.[INDEX].duplicate_of.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"upload_skipped.items.[INDEX].duplicate_of.oneOf.1","typeLabel":"null"}],"uniqueKey":"upload_skipped.items.[INDEX].duplicate_of","typeLabel":"integer | null"}},"required":["name","reason"],"uniqueKey":"upload_skipped.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"upload_skipped","typeLabel":"object[]"}},"required":["added","skipped","upload_skipped"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"added":[{"id":123,"document_id":123,"original_filename":"\u003cstring>","status":"\u003cstring>","processing_order":123,"version_number":123,"extraction_status":"\u003cstring>","extracted_field_count":1,"expected_field_count":1,"extraction_message":"\u003cstring>"}],"skipped":[{"document_id":123,"reason":"\u003cstring>","duplicate_of":123}],"upload_skipped":[{"name":"\u003cstring>","reason":"\u003cstring>","duplicate_of":123}]}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"94aedfab-458e-4497-9e5f-b12aea297b7c":{"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"},"5751cdb5-1a0a-47ef-8a4a-a081346b9575":{"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"},"0f8a3c30-7204-4b35-ad8f-5efd961efd1f":{"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":{"2f23de64-8d90-4eac-861b-9913bd76e000":{"extractApiKey":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Extract API key (sk-abacus-*)","scopes":[],"schemeName":"extractApiKey"}},"5c451420-9a83-4f10-a24e-0dd28e3f31b0":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter your Auth0 JWT token","scopes":[],"schemeName":"bearerAuth"}},"b670e5cf-39e5-4cc9-a436-6ad567bfd6b1":{"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":"Upload and add files - Abacus Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-20T18:35:33.433Z","originalFileLocation":"api-reference/batches/upload-and-add.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=\"Upload files into an existing batch and extract.\">\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=\"Upload and add files - Abacus Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload files into an existing batch and extract.\">\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/upload-and-add\">\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=Upload+and+add+files\u0026amp;description=Upload+files+into+an+existing+batch+and+extract.\u0026amp;theme=9ad23ac21ef16a116c90afc7\u0026amp;signature=003b1ff81c30521d4a25c8def1be99f91bfff2abd769d49aa164c5cfe949ff83\">\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=\"Upload and add files - Abacus Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload files into an existing batch and extract.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://abacus-docs.mintlify.site/_mintlify/api/og/v2?division=Batches\u0026amp;title=Upload+and+add+files\u0026amp;description=Upload+files+into+an+existing+batch+and+extract.\u0026amp;theme=9ad23ac21ef16a116c90afc7\u0026amp;signature=003b1ff81c30521d4a25c8def1be99f91bfff2abd769d49aa164c5cfe949ff83\">\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/upload-and-add\">\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/upload-and-add.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/upload-and-add#webpage\",\"url\":\"https://help.abacusdocs.com/api-reference/batches/upload-and-add\",\"name\":\"Upload and add files\",\"description\":\"Upload files into an existing batch and extract.\",\"dateModified\":\"2026-09-20T18:35:33.433Z\",\"isPartOf\":{\"@id\":\"https://help.abacusdocs.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.abacusdocs.com/api-reference/batches/upload-and-add#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.abacusdocs.com/api-reference/batches/upload-and-add#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Batches\",\"item\":\"https://help.abacusdocs.com/api-reference/batches/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upload and add files\",\"item\":\"https://help.abacusdocs.com/api-reference/batches/upload-and-add\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.abacusdocs.com/api-reference/batches/upload-and-add#apireference\",\"headline\":\"Upload and add files\",\"name\":\"Upload and add files\",\"description\":\"Upload files into an existing batch and extract.\",\"url\":\"https://help.abacusdocs.com/api-reference/batches/upload-and-add\",\"mainEntityOfPage\":{\"@id\":\"https://help.abacusdocs.com/api-reference/batches/upload-and-add#webpage\"},\"dateModified\":\"2026-09-20T18:35:33.433Z\",\"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/upload-and-add.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/","description":"Cancel pending or processing documents in a batch.","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/","description":"Re-extract documents in a batch.","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":"Upload and add files - 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"]}