{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Meibel","colors":{"primary":"#1A3D96","light":"#E5EBF7","dark":"#0F2560"},"logo":{"light":"https://mintcdn.com/meibel/ZcVTo2kAJOf_5ouC/logo/meibel-logo-blue.svg?fit=max\u0026auto=format\u0026n=ZcVTo2kAJOf_5ouC\u0026q=85\u0026s=dd566e01ec4422739d1864c6cd6b0c6c","dark":"https://mintcdn.com/meibel/ZcVTo2kAJOf_5ouC/logo/meibel-logo-white.svg?fit=max\u0026auto=format\u0026n=ZcVTo2kAJOf_5ouC\u0026q=85\u0026s=d84f49861d51bd519a1d4d109614ff83"},"favicon":"https://mintcdn.com/meibel/4ViI0XweY4rb3EuZ/favicon.ico?fit=max\u0026auto=format\u0026n=4ViI0XweY4rb3EuZ\u0026q=85\u0026s=7a4885b7399ebfb7b51a3d9e4bc83f6c","background":{"decoration":"grid"},"navbar":{"links":[{"icon":"web","href":"https://meibel.ai","label":""},{"icon":"github","href":"https://github.com/meibel-ai","label":""},{"icon":"envelope","href":"mailto:support@meibel.ai","label":""}]},"footer":{"socials":{"github":"https://github.com/meibel-ai","linkedin":"https://linkedin.com/company/meibel"}},"seo":{"metatags":{"og:site_name":"Meibel Documentation","og:type":"website"},"organization":{"name":"Meibel","url":"https://meibel.ai","logo":"https://docs.meibel.ai/logo/meibel-logo-blue.svg","sameAs":["https://github.com/meibel-ai","https://linkedin.com/company/meibel"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Aeonik Pro","source":"https://storage.googleapis.com/meibel-fonts/Aeonik-Regular.woff2","format":"woff2"},"body":{"family":"Aeonik Pro","source":"https://storage.googleapis.com/meibel-fonts/Aeonik-Regular.woff2","format":"woff2"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","icon":"desktop","href":"https://app.meibel.ai"},{"anchor":"Blog","icon":"newspaper","href":"https://www.meibel.ai/feed"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"meibel","hasAudioNarration":false,"actualSubdomain":"meibel","customDomains":["docs.meibel.ai"],"gitSource":{"type":"github","owner":"meibel-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1f858b8d58072c02133d5","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":95},{"language":"default","tag":"API endpoints","count":83},{"language":"default","tag":"Documentation","count":29},{"language":"default","tag":"Datasources","count":23},{"language":"default","tag":"Batches","count":15},{"language":"default","tag":"Documents","count":15},{"language":"default","tag":"Agents","count":12},{"language":"default","tag":"Data and documents","count":9},{"language":"default","tag":"Core concepts","count":8},{"language":"default","tag":"Document parsing","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/endpoints/batch-definitions/create-batch-definition","slug":"/api-reference/v2/endpoints/batch-definitions/create-batch-definition","pageMetadata":{"title":"Create Batch Definition","description":null,"deprecated":null,"version":null,"openapi":"/api-v2.json post /batch-definitions","href":"/api-reference/v2/endpoints/batch-definitions/create-batch-definition","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Batch Definition","description":null,"deprecated":null,"version":null,"openapi":"/api-v2.json post /batch-definitions","href":"/api-reference/v2/endpoints/batch-definitions/create-batch-definition","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Batch Definitions"],"summary":"Create Batch Definition","operationId":"createBatch","security":["cb982d7a-5127-484e-84cb-bd36662b5f1a"],"requestBody":"dd0a549f-2c3c-4d59-8343-15e48fbc5959","responses":{"201":"1c204efc-b4a2-451b-8781-d6b19bd80b7f","422":"da970099-2dae-465c-bf3f-896b0392fd08"},"x-codeSamples":[{"lang":"Python","label":"Python","source":"import os\nfrom meibel import MeibelClient\nfrom meibel.models import CreateBatchDefinitionRequest, BatchDefinitionFilters\n\nclient = MeibelClient(api_key=os.environ[\"MEIBEL_API_KEY\"])\n\nbatch_definition = client.batches.create(\n CreateBatchDefinitionRequest(\n name=\"invoice-extraction-batch\",\n agent_id=\"agent_8f3a1c\",\n input_datasource_id=\"ds_input_7b2c9d\",\n output_datasource_id=\"ds_output_4e1f0a\",\n filters=BatchDefinitionFilters(\n regex=r\".*\\.pdf$\",\n media_types=[\"application/pdf\"],\n ),\n user_message=\"Extract line items and totals from each invoice.\",\n concurrency=5,\n retry_limit=3,\n recurrence_cron=\"0 2 * * *\",\n description=\"Nightly batch extraction of vendor invoices.\",\n )\n)\n\nprint(f\"Created batch definition {batch_definition.id} v{batch_definition.version}\")"},{"lang":"TypeScript","label":"TypeScript","source":"import { MeibelClient } from \"meibel\";\n\nconst client = new MeibelClient({ apiKey: process.env.MEIBEL_API_KEY });\n\nconst batchDefinition = await client.batches.create({\n name: \"invoice-extraction-batch\",\n agent_id: \"agent_7f3a9c2b\",\n input_datasource_id: \"ds_invoices_raw\",\n output_datasource_id: \"ds_invoices_processed\",\n description: \"Extracts structured fields from monthly invoice PDFs\",\n user_message: \"Extract vendor, total, and due date from each invoice.\",\n concurrency: 5,\n retry_limit: 3,\n recurrence_cron: \"0 2 * * 1\",\n filters: {\n regex: \"^invoice-.*\\\\.pdf$\",\n media_types: [\"application/pdf\"],\n },\n execution_policy: {\n datasources: {\n ds_invoices_raw: {\n documents: {\n filter: { \"data_element.__name__\": { $in: [\"invoice-2024-01.pdf\"] } },\n },\n },\n },\n tools: {\n web_search: {\n disabled: true,\n },\n },\n },\n});\n\nconsole.log(`Created batch definition ${batchDefinition.id} (v${batchDefinition.version})`);"},{"lang":"Go","label":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"os\"\n\n\tv2 \"github.com/meibel-ai/meibel-go/v2\"\n)\n\nfunc main() {\n\tclient := v2.NewClient(v2.WithAPIKey(os.Getenv(\"MEIBEL_API_KEY\")))\n\n\tbatch, err := client.Batches.Create(context.Background(), v2.CreateBatchDefinitionRequest{\n\t\tName: \"invoice-extraction-batch\",\n\t\tAgentID: \"agent_abc123\",\n\t\tInputDatasourceID: \"ds_invoices_raw\",\n\t\tFilters: \u0026v2.BatchDefinitionFilters{\n\t\t\tMediaTypes: []string{\"application/pdf\"},\n\t\t},\n\t\tOutputDatasourceID: v2.String(\"ds_invoices_processed\"),\n\t\tUserMessage: v2.String(\"Extract line items and totals from each invoice\"),\n\t\tConcurrency: v2.Int(5),\n\t\tRetryLimit: v2.Int(3),\n\t\tDescription: v2.String(\"Nightly batch extraction of invoice data\"),\n\t})\n\tif err != nil {\n\t\tfmt.Println(\"error creating batch definition:\", err)\n\t\treturn\n\t}\n\n\tfmt.Printf(\"created batch definition %s (version %s)\\n\", batch.ID, batch.Version)\n}"}],"method":"post","type":"path","servers":["24ab8823-08da-416b-8f3d-f535f0304061","fe67c19a-7c02-4e88-af01-d8c4ae665c9b","0e2fd376-4742-423f-afc6-f5d524b08a42"],"path":"/batch-definitions","baseUrlOptions":["https://api.meibel.ai/v2","https://api.dev.meibel.ai/v2","http://localhost:8000/v2"],"title":"Create Batch Definition","description":"","codeSamples":[{"label":"Python","lang":"Python","source":"import os\nfrom meibel import MeibelClient\nfrom meibel.models import CreateBatchDefinitionRequest, BatchDefinitionFilters\n\nclient = MeibelClient(api_key=os.environ[\"MEIBEL_API_KEY\"])\n\nbatch_definition = client.batches.create(\n CreateBatchDefinitionRequest(\n name=\"invoice-extraction-batch\",\n agent_id=\"agent_8f3a1c\",\n input_datasource_id=\"ds_input_7b2c9d\",\n output_datasource_id=\"ds_output_4e1f0a\",\n filters=BatchDefinitionFilters(\n regex=r\".*\\.pdf$\",\n media_types=[\"application/pdf\"],\n ),\n user_message=\"Extract line items and totals from each invoice.\",\n concurrency=5,\n retry_limit=3,\n recurrence_cron=\"0 2 * * *\",\n description=\"Nightly batch extraction of vendor invoices.\",\n )\n)\n\nprint(f\"Created batch definition {batch_definition.id} v{batch_definition.version}\")"},{"label":"TypeScript","lang":"TypeScript","source":"import { MeibelClient } from \"meibel\";\n\nconst client = new MeibelClient({ apiKey: process.env.MEIBEL_API_KEY });\n\nconst batchDefinition = await client.batches.create({\n name: \"invoice-extraction-batch\",\n agent_id: \"agent_7f3a9c2b\",\n input_datasource_id: \"ds_invoices_raw\",\n output_datasource_id: \"ds_invoices_processed\",\n description: \"Extracts structured fields from monthly invoice PDFs\",\n user_message: \"Extract vendor, total, and due date from each invoice.\",\n concurrency: 5,\n retry_limit: 3,\n recurrence_cron: \"0 2 * * 1\",\n filters: {\n regex: \"^invoice-.*\\\\.pdf$\",\n media_types: [\"application/pdf\"],\n },\n execution_policy: {\n datasources: {\n ds_invoices_raw: {\n documents: {\n filter: { \"data_element.__name__\": { $in: [\"invoice-2024-01.pdf\"] } },\n },\n },\n },\n tools: {\n web_search: {\n disabled: true,\n },\n },\n },\n});\n\nconsole.log(`Created batch definition ${batchDefinition.id} (v${batchDefinition.version})`);"},{"label":"Go","lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"os\"\n\n\tv2 \"github.com/meibel-ai/meibel-go/v2\"\n)\n\nfunc main() {\n\tclient := v2.NewClient(v2.WithAPIKey(os.Getenv(\"MEIBEL_API_KEY\")))\n\n\tbatch, err := client.Batches.Create(context.Background(), v2.CreateBatchDefinitionRequest{\n\t\tName: \"invoice-extraction-batch\",\n\t\tAgentID: \"agent_abc123\",\n\t\tInputDatasourceID: \"ds_invoices_raw\",\n\t\tFilters: \u0026v2.BatchDefinitionFilters{\n\t\t\tMediaTypes: []string{\"application/pdf\"},\n\t\t},\n\t\tOutputDatasourceID: v2.String(\"ds_invoices_processed\"),\n\t\tUserMessage: v2.String(\"Extract line items and totals from each invoice\"),\n\t\tConcurrency: v2.Int(5),\n\t\tRetryLimit: v2.Int(3),\n\t\tDescription: v2.String(\"Nightly batch extraction of invoice data\"),\n\t})\n\tif err != nil {\n\t\tfmt.Println(\"error creating batch definition:\", err)\n\t\treturn\n\t}\n\n\tfmt.Printf(\"created batch definition %s (version %s)\\n\", batch.ID, batch.Version)\n}"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"type":"string","title":"Name","description":"Kebab-case label (non-unique within tenant)","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"agent_id":{"type":"string","title":"Agent Id","description":"AgentDefinition ID; resolved + pinned at creation time","isRequired":true,"uniqueKey":"agent_id","typeLabel":"string"},"input_datasource_id":{"type":"string","title":"Input Datasource Id","description":"Datasource holding the input Data Elements","isRequired":true,"uniqueKey":"input_datasource_id","typeLabel":"string"},"filters":{"oneOf":[{"type":"object","title":"BatchDefinitionFilters","description":"Recipe-level filters. element_ids belongs here; per-execution overrides use BatchInputOverrides on the execution row.","properties":{"regex":{"oneOf":[{"type":"string","title":"Regex","description":"Filter Data Elements by name pattern (regex)","uniqueKey":"filters.oneOf.0.regex.oneOf.0","typeLabel":"string"},{"type":"null","title":"Regex","description":"Filter Data Elements by name pattern (regex)","uniqueKey":"filters.oneOf.0.regex.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.oneOf.0.regex","typeLabel":"string | null"},"media_types":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"filters.oneOf.0.media_types.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Media Types","description":"Filter Data Elements by content type","uniqueKey":"filters.oneOf.0.media_types.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Media Types","description":"Filter Data Elements by content type","uniqueKey":"filters.oneOf.0.media_types.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.oneOf.0.media_types","typeLabel":"string[] | null"},"element_ids":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"filters.oneOf.0.element_ids.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Element Ids","description":"Recipe-pinned subset of Data Element IDs.","uniqueKey":"filters.oneOf.0.element_ids.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Element Ids","description":"Recipe-pinned subset of Data Element IDs.","uniqueKey":"filters.oneOf.0.element_ids.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.oneOf.0.element_ids","typeLabel":"string[] | null"}},"uniqueKey":"filters.oneOf.0","typeLabel":"BatchDefinitionFilters · object"},{"type":"null","uniqueKey":"filters.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters","typeLabel":"BatchDefinitionFilters · object | null"},"output_datasource_id":{"oneOf":[{"type":"string","title":"Output Datasource Id","description":"Pinned output sink. NULL = workflow auto-creates per execution.","uniqueKey":"output_datasource_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Output Datasource Id","description":"Pinned output sink. NULL = workflow auto-creates per execution.","uniqueKey":"output_datasource_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"output_datasource_id","typeLabel":"string | null"},"user_message":{"oneOf":[{"type":"string","title":"User Message","uniqueKey":"user_message.oneOf.0","typeLabel":"string"},{"type":"null","title":"User Message","uniqueKey":"user_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_message","typeLabel":"string | null"},"concurrency":{"oneOf":[{"type":"integer","title":"Concurrency","default":10,"maximum":999,"minimum":1,"uniqueKey":"concurrency.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Concurrency","default":10,"uniqueKey":"concurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"concurrency","typeLabel":"integer | null"},"retry_limit":{"oneOf":[{"type":"integer","title":"Retry Limit","default":2,"maximum":999,"minimum":0,"uniqueKey":"retry_limit.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retry Limit","default":2,"uniqueKey":"retry_limit.oneOf.1","typeLabel":"null"}],"uniqueKey":"retry_limit","typeLabel":"integer | null"},"recurrence_cron":{"oneOf":[{"type":"string","title":"Recurrence Cron","description":"Cron expression validated by croniter; not yet scheduled in DEL-1376.","uniqueKey":"recurrence_cron.oneOf.0","typeLabel":"string"},{"type":"null","title":"Recurrence Cron","description":"Cron expression validated by croniter; not yet scheduled in DEL-1376.","uniqueKey":"recurrence_cron.oneOf.1","typeLabel":"null"}],"uniqueKey":"recurrence_cron","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"execution_policy":{"oneOf":[{"type":"object","title":"ExecutionPolicy","description":"Inline execution policy constraints (datasources, tools)","properties":{"datasources":{"oneOf":[{"type":"object","title":"Datasources","description":"Per-datasource access controls, keyed by datasource_id. Each entry can disable the datasource entirely or apply TAG/RAG filters to restrict which data is accessible.","additionalProperties":{"properties":{"disabled":{"oneOf":[{"type":"boolean","title":"Disabled","description":"When true, the datasource is entirely inaccessible for this session. All queries against it will be blocked.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.disabled.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Disabled","description":"When true, the datasource is entirely inaccessible for this session. All queries against it will be blocked.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.disabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.disabled","typeLabel":"boolean | null"},"tables":{"oneOf":[{"type":"object","title":"TagConstraints","description":"TAG (SQL/database) constraints. Controls table/row access and column redaction.","properties":{"filter":{"oneOf":[{"type":"object","title":"Filter","description":"Optional override for the tool's parameters schema","additionalProperties":true,"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.filter.oneOf.0","typeLabel":"Filter · object"},{"type":"null","title":"Filter","description":"Optional override for the tool's parameters schema","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.filter.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.filter","typeLabel":"Filter · object | null"},"hidden_columns":{"oneOf":[{"type":"object","title":"Hidden Columns","description":"Per-table column names to redact from query output. Keyed by table name; values are lists of column names. Columns remain usable in WHERE/JOIN — only the final result values are stripped.","additionalProperties":{"items":{"type":"string","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_columns.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_columns.oneOf.0.additionalProperties","typeLabel":"string[]"},"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_columns.oneOf.0","typeLabel":"Hidden Columns · object"},{"type":"null","title":"Hidden Columns","description":"Per-table column names to redact from query output. Keyed by table name; values are lists of column names. Columns remain usable in WHERE/JOIN — only the final result values are stripped.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_columns.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_columns","typeLabel":"Hidden Columns · object | null"},"hidden_tables":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_tables.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Hidden Tables","description":"Table names whose columns are fully redacted from query output. Tables remain queryable in WHERE/JOIN — only SELECT output is stripped.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_tables.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Hidden Tables","description":"Table names whose columns are fully redacted from query output. Tables remain queryable in WHERE/JOIN — only SELECT output is stripped.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_tables.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0.hidden_tables","typeLabel":"string[] | null"}},"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.0","typeLabel":"TagConstraints · object"},{"type":"null","description":"TAG (SQL/database) constraints. Controls table/row access and column redaction.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.tables","typeLabel":"TagConstraints · object | null"},"documents":{"oneOf":[{"type":"object","title":"RagConstraints","description":"RAG (vector search) constraints. Controls which documents can be retrieved.","properties":{"filter":{"oneOf":[{"type":"object","title":"Filter","description":"Optional override for the tool's parameters schema","additionalProperties":true,"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.documents.oneOf.0.filter.oneOf.0","typeLabel":"Filter · object"},{"type":"null","title":"Filter","description":"Optional override for the tool's parameters schema","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.documents.oneOf.0.filter.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.documents.oneOf.0.filter","typeLabel":"Filter · object | null"}},"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.documents.oneOf.0","typeLabel":"RagConstraints · object"},{"type":"null","description":"RAG (vector search) constraints. Controls which documents can be retrieved.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.documents.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties.documents","typeLabel":"RagConstraints · object | null"}},"type":"object","title":"DatasourceView","description":"Access controls for a single datasource. Each datasource can be entirely disabled, or selectively constrained via TAG (SQL) and/or RAG (vector search) filters. Keyed by datasource_id in ``ExecutionPolicy.datasources``.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0.additionalProperties","typeLabel":"DatasourceView · object"},"uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.0","typeLabel":"Datasources · object"},{"type":"null","title":"Datasources","description":"Per-datasource access controls, keyed by datasource_id. Each entry can disable the datasource entirely or apply TAG/RAG filters to restrict which data is accessible.","uniqueKey":"execution_policy.oneOf.0.datasources.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.datasources","typeLabel":"Datasources · object | null"},"tools":{"oneOf":[{"type":"object","title":"Tools","description":"Per-tool access controls, keyed by tool instance name. Each entry can disable the tool entirely or constrain its parameters to specific values or ranges.","additionalProperties":{"properties":{"disabled":{"oneOf":[{"type":"boolean","title":"Disabled","description":"When true, the tool is removed from the agent's toolkit for this session. The agent will not be able to invoke it.","uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0.additionalProperties.disabled.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Disabled","description":"When true, the tool is removed from the agent's toolkit for this session. The agent will not be able to invoke it.","uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0.additionalProperties.disabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0.additionalProperties.disabled","typeLabel":"boolean | null"},"variables":{"oneOf":[{"type":"object","title":"Variables","description":"Optional override for the tool's parameters schema","additionalProperties":true,"uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0.additionalProperties.variables.oneOf.0","typeLabel":"Variables · object"},{"type":"null","title":"Variables","description":"Optional override for the tool's parameters schema","uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0.additionalProperties.variables.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0.additionalProperties.variables","typeLabel":"Variables · object | null"}},"type":"object","title":"ToolConfig","description":"Access controls for a single tool instance. Tools can be entirely disabled, or have their parameters constrained to specific values or ranges. Keyed by tool instance name in ``ExecutionPolicy.tools``. Variable constraints use the same MongoDB-style operators as datasource filters. Plain values are automatically normalized to ``{\"$eq\": value}`` on construction. All constraints are: 1. Annotated in the tool's parameter schema (visible to the LLM) 2. Validated at execution time (enforced by the platform) Supported operators: - Comparison: ``$eq``, ``$ne``, ``$gt``, ``$gte``, ``$lt``, ``$lte`` - Set: ``$in``, ``$nin`` - Logical: ``$and``, ``$or``, ``$not``","uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0.additionalProperties","typeLabel":"ToolConfig · object"},"uniqueKey":"execution_policy.oneOf.0.tools.oneOf.0","typeLabel":"Tools · object"},{"type":"null","title":"Tools","description":"Per-tool access controls, keyed by tool instance name. Each entry can disable the tool entirely or constrain its parameters to specific values or ranges.","uniqueKey":"execution_policy.oneOf.0.tools.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy.oneOf.0.tools","typeLabel":"Tools · object | null"}},"uniqueKey":"execution_policy.oneOf.0","typeLabel":"ExecutionPolicy · object"},{"type":"null","description":"Inline execution policy constraints (datasources, tools)","uniqueKey":"execution_policy.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy","typeLabel":"ExecutionPolicy · object | null"},"execution_policy_ids":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"execution_policy_ids.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Execution Policy Ids","description":"IDs of stored ExecutionPolicies to compose","uniqueKey":"execution_policy_ids.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Execution Policy Ids","description":"IDs of stored ExecutionPolicies to compose","uniqueKey":"execution_policy_ids.oneOf.1","typeLabel":"null"}],"uniqueKey":"execution_policy_ids","typeLabel":"string[] | null"}},"type":"object","required":["name","agent_id","input_datasource_id"],"title":"CreateBatchDefinitionRequest","description":"Create a new BatchDefinition lineage.","uniqueKey":"","typeLabel":"CreateBatchDefinitionRequest · object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","agent_id":"\u003cstring>","input_datasource_id":"\u003cstring>","filters":{"regex":"\u003cstring>","media_types":["\u003cstring>"],"element_ids":["\u003cstring>"]},"output_datasource_id":"\u003cstring>","user_message":"\u003cstring>","concurrency":10,"retry_limit":2,"recurrence_cron":"\u003cstring>","description":"\u003cstring>","execution_policy":{"datasources":{},"tools":{}},"execution_policy_ids":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1c204efc-b4a2-451b-8781-d6b19bd80b7f":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"catalog_urn":{"type":"string","title":"Catalog Urn","isRequired":true,"uniqueKey":"catalog_urn","typeLabel":"string"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"version":{"type":"string","title":"Version","isRequired":true,"uniqueKey":"version","typeLabel":"string"}},"type":"object","required":["id","catalog_urn","name","version"],"title":"CreateBatchDefinitionResponse","description":"Compact post-create payload mirroring CreateAgentDefinitionResponse.","uniqueKey":"","typeLabel":"CreateBatchDefinitionResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","catalog_urn":"\u003cstring>","name":"\u003cstring>","version":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"da970099-2dae-465c-bf3f-896b0392fd08":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"cb982d7a-5127-484e-84cb-bd36662b5f1a":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"Meibel-API-Key","scopes":[]}}},"servers":{"24ab8823-08da-416b-8f3d-f535f0304061":{"url":"https://api.meibel.ai/v2","description":"Meibel API (v2)"},"fe67c19a-7c02-4e88-af01-d8c4ae665c9b":{"url":"https://api.dev.meibel.ai/v2","description":"Meibel Dev API (v2)"},"0e2fd376-4742-423f-afc6-f5d524b08a42":{"url":"http://localhost:8000/v2","description":"Local Development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Meibel-API-Key","scopes":[]},"schema":{"title":"Meibel-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"Meibel-API-Key"}],"title":"APIKeyHeader"}]},"originalFileLocation":"api-v2.json"},"subdomain":"meibel","siteName":"Meibel","title":"Create Batch Definition - Meibel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T13:28:17.234Z","originalFileLocation":"api-reference/v2/endpoints/batch-definitions/create-batch-definition.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=\"application-name\" content=\"Meibel\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Batch Definition - Meibel\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Meibel Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://meibel.mintlify.site/_mintlify/api/og/v2?division=Batches\u0026amp;title=Create+Batch+Definition\u0026amp;theme=fd43682c474722449b67936b\u0026amp;signature=8bcba9f3a27dd91adce98fa68ee29f0170d5ce71719332a526cb088171d6eb1e\">\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=\"Create Batch Definition - Meibel\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://meibel.mintlify.site/_mintlify/api/og/v2?division=Batches\u0026amp;title=Create+Batch+Definition\u0026amp;theme=fd43682c474722449b67936b\u0026amp;signature=8bcba9f3a27dd91adce98fa68ee29f0170d5ce71719332a526cb088171d6eb1e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/meibel/sU6oWNMQD-K5jOcK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Meibel\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A3D96\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/endpoints/batch-definitions/create-batch-definition.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://meibel.ai/#organization\",\"name\":\"Meibel\",\"url\":\"https://meibel.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.meibel.ai/logo/meibel-logo-blue.svg\"},\"sameAs\":[\"https://github.com/meibel-ai\",\"https://linkedin.com/company/meibel\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.meibel.ai#website\",\"name\":\"Meibel\",\"url\":\"https://docs.meibel.ai\",\"publisher\":{\"@id\":\"https://meibel.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition#webpage\",\"url\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition\",\"name\":\"Create Batch Definition\",\"dateModified\":\"2026-10-28T13:28:17.234Z\",\"isPartOf\":{\"@id\":\"https://docs.meibel.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API endpoints\",\"item\":\"https://docs.meibel.ai/api-reference/v2/endpoints/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Batches\",\"item\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/list-batch-definitions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Batch Definition\",\"item\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition#apireference\",\"headline\":\"Create Batch Definition\",\"name\":\"Create Batch Definition\",\"url\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition\",\"mainEntityOfPage\":{\"@id\":\"https://docs.meibel.ai/api-reference/v2/endpoints/batch-definitions/create-batch-definition#webpage\"},\"dateModified\":\"2026-10-28T13:28:17.234Z\",\"publisher\":{\"@id\":\"https://meibel.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.meibel.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Meibel\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Meibel","nav":{"global":{"anchors":[{"anchor":"App","icon":"desktop","href":"https://app.meibel.ai"},{"anchor":"Blog","icon":"newspaper","href":"https://www.meibel.ai/feed"}]},"tabs":[{"tab":"Welcome","icon":"house","pages":[{"title":"Welcome","href":""}]},{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/installation"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Get started","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Rate Limits","href":"/api-reference/rate-limits"}]},{"group":"SDKs","pages":[{"title":"Python SDK","href":"/sdk/python"},{"title":"TypeScript SDK","href":"/sdk/nodejs"},{"title":"Go SDK","href":"/sdk/go"},{"title":"CLI","href":"/sdk/cli"}]},{"group":"API guides","pages":[{"title":"Pagination","href":"/api-ref-guides/pagination"},{"title":"Streaming","href":"/api-ref-guides/streaming"},{"title":"File Uploads","href":"/api-ref-guides/file-uploads"},{"title":"Error Handling","href":"/api-ref-guides/error-handling"}]},{"group":"API endpoints","pages":[{"group":"Agents","pages":[{"title":"List Agents","deprecated":null,"version":null,"openapi":"/api-v2.json get /agents","href":"/api-reference/v2/endpoints/agents/list-agents"},{"title":"Create Agent","deprecated":null,"version":null,"openapi":"/api-v2.json post /agents","href":"/api-reference/v2/endpoints/agents/create-agent"},{"title":"Get Agent","deprecated":null,"version":null,"openapi":"/api-v2.json get /agents/{agent_id}","href":"/api-reference/v2/endpoints/agents/get-agent"},{"title":"Update Agent","deprecated":null,"version":null,"openapi":"/api-v2.json put /agents/{agent_id}","href":"/api-reference/v2/endpoints/agents/update-agent"},{"title":"Delete Agent","deprecated":null,"version":null,"openapi":"/api-v2.json delete /agents/{agent_id}","href":"/api-reference/v2/endpoints/agents/delete-agent"},{"title":"Publish Agent","deprecated":null,"version":null,"openapi":"/api-v2.json post /agents/{agent_id}/publish","href":"/api-reference/v2/endpoints/agents/publish-agent"},{"title":"List Agent Versions","deprecated":null,"version":null,"openapi":"/api-v2.json get /agents/{agent_id}/versions","href":"/api-reference/v2/endpoints/agents/list-agent-versions"},{"group":"Sessions","pages":[{"title":"Create Session By Name","deprecated":null,"version":null,"openapi":"/api-v2.json post /agents/name/{name}/sessions","href":"/api-reference/v2/endpoints/agents/create-session-by-name"},{"title":"List Sessions","deprecated":null,"version":null,"openapi":"/api-v2.json get /agents/{agent_id}/sessions","href":"/api-reference/v2/endpoints/agents/list-sessions"},{"title":"Create Session","deprecated":null,"version":null,"openapi":"/api-v2.json post /agents/{agent_id}/sessions","href":"/api-reference/v2/endpoints/agents/create-session"},{"title":"Send Chat Message","deprecated":null,"version":null,"openapi":"/api-v2.json post /sessions/{session_id}/chat","href":"/api-reference/v2/endpoints/sessions/send-chat-message"},{"title":"Send a chat message with file attachments and stream the response via SSE","deprecated":null,"version":null,"openapi":"/api-v2.json post /sessions/{session_id}/chat/stream","href":"/api-reference/v2/endpoints/sessions/send-a-chat-message-with-file-attachments-and-stream-the-response-via-sse"}]}]},{"group":"Sessions","pages":[{"title":"Get Session","deprecated":null,"version":null,"openapi":"/api-v2.json get /sessions/{session_id}","href":"/api-reference/v2/endpoints/sessions/get-session"},{"title":"Get Session Messages","deprecated":null,"version":null,"openapi":"/api-v2.json get /sessions/{session_id}/messages","href":"/api-reference/v2/endpoints/sessions/get-session-messages"}]},{"group":"Artifact schemas","pages":[{"title":"List Artifact Schemas","deprecated":null,"version":null,"openapi":"/api-v2.json get /artifact-schemas","href":"/api-reference/v2/endpoints/artifact-schemas/list-artifact-schemas"},{"title":"Create Artifact Schema","deprecated":null,"version":null,"openapi":"/api-v2.json post /artifact-schemas","href":"/api-reference/v2/endpoints/artifact-schemas/create-artifact-schema"},{"title":"Get Artifact Schema","deprecated":null,"version":null,"openapi":"/api-v2.json get /artifact-schemas/{artifact_id}","href":"/api-reference/v2/endpoints/artifact-schemas/get-artifact-schema"},{"title":"Update Artifact Schema","deprecated":null,"version":null,"openapi":"/api-v2.json put /artifact-schemas/{artifact_id}","href":"/api-reference/v2/endpoints/artifact-schemas/update-artifact-schema"},{"title":"Delete Artifact Schema","deprecated":null,"version":null,"openapi":"/api-v2.json delete /artifact-schemas/{artifact_id}","href":"/api-reference/v2/endpoints/artifact-schemas/delete-artifact-schema"}]},{"group":"Datasources","pages":[{"title":"List Datasources","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources","href":"/api-reference/v2/endpoints/datasources/list-datasources"},{"title":"Create Datasource","deprecated":null,"version":null,"openapi":"/api-v2.json post /datasources","href":"/api-reference/v2/endpoints/datasources/create-datasource"},{"title":"Get Datasource","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}","href":"/api-reference/v2/endpoints/datasources/get-datasource"},{"title":"Update Datasource","deprecated":null,"version":null,"openapi":"/api-v2.json put /datasources/{datasource_id}","href":"/api-reference/v2/endpoints/datasources/update-datasource"},{"title":"Delete Datasource","deprecated":null,"version":null,"openapi":"/api-v2.json delete /datasources/{datasource_id}","href":"/api-reference/v2/endpoints/datasources/delete-datasource"},{"group":"Tables","pages":[{"title":"List Tables","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/tables","href":"/api-reference/v2/endpoints/table-descriptions/list-tables"},{"title":"Update Table Descriptions","deprecated":null,"version":null,"openapi":"/api-v2.json put /datasources/{datasource_id}/tables","href":"/api-reference/v2/endpoints/table-descriptions/update-table-descriptions"},{"title":"List Columns","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/tables/{table_name}/columns","href":"/api-reference/v2/endpoints/table-descriptions/list-columns"},{"title":"Update Column Descriptions","deprecated":null,"version":null,"openapi":"/api-v2.json put /datasources/{datasource_id}/tables/{table_name}/columns","href":"/api-reference/v2/endpoints/table-descriptions/update-column-descriptions"}]},{"group":"Data elements","pages":[{"title":"List Data Elements","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/data-elements","href":"/api-reference/v2/endpoints/data-elements/list-data-elements"},{"title":"Get Data Element","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/data-elements/{data_element_id}","href":"/api-reference/v2/endpoints/data-elements/get-data-element"},{"title":"Update Data Element","deprecated":null,"version":null,"openapi":"/api-v2.json put /datasources/{datasource_id}/data-elements/{data_element_id}","href":"/api-reference/v2/endpoints/data-elements/update-data-element"},{"title":"Search Data Elements","deprecated":null,"version":null,"openapi":"/api-v2.json post /datasources/{datasource_id}/data-elements/search","href":"/api-reference/v2/endpoints/data-elements/search-data-elements"}]},{"group":"File uploads","pages":[{"title":"List Content","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/content","href":"/api-reference/v2/endpoints/file-upload/list-content"},{"title":"Upload Content (async)","deprecated":null,"version":null,"openapi":"/api-v2.json post /datasources/{datasource_id}/content","href":"/api-reference/v2/endpoints/file-upload/upload-content-async"},{"title":"Upload Content (sync)","deprecated":null,"version":null,"openapi":"/api-v2.json post /datasources/{datasource_id}/content/process","href":"/api-reference/v2/endpoints/file-upload/upload-content-sync"},{"title":"Stream Upload Progress","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/uploads/{upload_id}/progress","href":"/api-reference/v2/endpoints/file-upload/stream-upload-progress"}]},{"group":"Downloads","pages":[{"title":"Create Download Job (async)","deprecated":null,"version":null,"openapi":"/api-v2.json post /datasources/{datasource_id}/downloads","href":"/api-reference/v2/endpoints/datasource-downloads/create-download-job-async"},{"title":"Process Download (sync)","deprecated":null,"version":null,"openapi":"/api-v2.json post /datasources/{datasource_id}/downloads/process","href":"/api-reference/v2/endpoints/datasource-downloads/process-download-sync"},{"title":"Stream Download Progress","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/downloads/{job_id}/progress","href":"/api-reference/v2/endpoints/datasource-downloads/stream-download-progress"},{"title":"Download File","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/downloads/{job_id}/file","href":"/api-reference/v2/endpoints/datasource-downloads/download-file"}]},{"group":"Ingest","pages":[{"title":"Trigger Ingest","deprecated":null,"version":null,"openapi":"/api-v2.json post /datasources/{datasource_id}/trigger-ingest","href":"/api-reference/v2/endpoints/ingest/trigger-ingest"},{"title":"Get Ingest Status","deprecated":null,"version":null,"openapi":"/api-v2.json get /datasources/{datasource_id}/ingest-status","href":"/api-reference/v2/endpoints/ingest/get-ingest-status"}]}]},{"group":"Documents","pages":[{"title":"Parse a document (async)","deprecated":null,"version":null,"openapi":"/api-v2.json post /documents","href":"/api-reference/v2/endpoints/documents/parse-a-document-async"},{"title":"Parse a document (sync)","deprecated":null,"version":null,"openapi":"/api-v2.json post /documents/process","href":"/api-reference/v2/endpoints/documents/parse-a-document-sync"},{"title":"Get document parsing status","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/{job_id}","href":"/api-reference/v2/endpoints/documents/get-document-parsing-status"},{"title":"Get parsed document result","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/{job_id}/result","href":"/api-reference/v2/endpoints/documents/get-parsed-document-result"},{"title":"Get structured parse result","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/{job_id}/structured","href":"/api-reference/v2/endpoints/documents/get-structured-parse-result"},{"title":"List child documents","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/{job_id}/children","href":"/api-reference/v2/endpoints/documents/list-child-documents"},{"title":"Stream document parsing trace","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/{job_id}/trace","href":"/api-reference/v2/endpoints/documents/stream-document-parsing-trace"},{"title":"Move documents into a datasource (async)","deprecated":null,"version":null,"openapi":"/api-v2.json post /documents/move","href":"/api-reference/v2/endpoints/documents/move-documents-into-a-datasource-async"},{"group":"Transform","pages":[{"title":"Transform a document using AI extraction (sync)","deprecated":null,"version":null,"openapi":"/api-v2.json post /documents/transform","href":"/api-reference/v2/endpoints/documents/transform-a-document-using-ai-extraction-sync"},{"title":"Submit a document transform (async)","deprecated":null,"version":null,"openapi":"/api-v2.json post /documents/transform/submit","href":"/api-reference/v2/endpoints/documents/submit-a-document-transform-async"}]},{"group":"Deep transform","pages":[{"title":"List deep-transform jobs","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/deep-transform","href":"/api-reference/v2/endpoints/documents/list-deep-transform-jobs"},{"title":"Submit a deep-transform extraction from a file upload (async)","deprecated":null,"version":null,"openapi":"/api-v2.json post /documents/deep-transform","href":"/api-reference/v2/endpoints/documents/submit-a-deep-transform-extraction-from-a-file-upload-async"},{"title":"Get deep-transform job status","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/deep-transform/{job_id}","href":"/api-reference/v2/endpoints/documents/get-deep-transform-job-status"},{"title":"Download a deep-transform artifact","deprecated":null,"version":null,"openapi":"/api-v2.json get /documents/deep-transform/{job_id}/artifact/{name}","href":"/api-reference/v2/endpoints/documents/download-a-deep-transform-artifact"},{"title":"Submit a deep-transform extraction reusing a parsed document (async)","deprecated":null,"version":null,"openapi":"/api-v2.json post /documents/deep-transform/from-document","href":"/api-reference/v2/endpoints/documents/submit-a-deep-transform-extraction-reusing-a-parsed-document-async"}]}]},{"group":"Batches","pages":[{"title":"List Batch Definitions","description":null,"deprecated":null,"version":null,"openapi":"/api-v2.json get /batch-definitions","href":"/api-reference/v2/endpoints/batch-definitions/list-batch-definitions"},{"title":"Create Batch Definition","deprecated":null,"version":null,"openapi":"/api-v2.json post /batch-definitions","href":"/api-reference/v2/endpoints/batch-definitions/create-batch-definition"},{"title":"Get Batch Definition By Catalog Urn","description":null,"deprecated":null,"version":null,"openapi":"/api-v2.json get /batch-definitions/catalog-urn","href":"/api-reference/v2/endpoints/batch-definitions/get-batch-definition-by-catalog-urn"},{"title":"Get Batch Definition By Id","deprecated":null,"version":null,"openapi":"/api-v2.json get /batch-definitions/id/{definition_id}","href":"/api-reference/v2/endpoints/batch-definitions/get-batch-definition-by-id"},{"title":"Update Batch Definition By Id","deprecated":null,"version":null,"openapi":"/api-v2.json put /batch-definitions/id/{definition_id}","href":"/api-reference/v2/endpoints/batch-definitions/update-batch-definition-by-id"},{"title":"Delete Batch Definition By Id","deprecated":null,"version":null,"openapi":"/api-v2.json delete /batch-definitions/id/{definition_id}","href":"/api-reference/v2/endpoints/batch-definitions/delete-batch-definition-by-id"},{"title":"List Batch Definition Versions","deprecated":null,"version":null,"openapi":"/api-v2.json get /batch-definitions/id/{definition_id}/versions","href":"/api-reference/v2/endpoints/batch-definitions/list-batch-definition-versions"},{"title":"Execute Batch Definition","deprecated":null,"version":null,"openapi":"/api-v2.json post /batch-definitions/id/{definition_id}/execute","href":"/api-reference/v2/endpoints/batch-definitions/execute-batch-definition"},{"group":"Executions","pages":[{"title":"List Batch Executions","deprecated":null,"version":null,"openapi":"/api-v2.json get /batch-executions","href":"/api-reference/v2/endpoints/batch-executions/list-batch-executions"},{"title":"Create Batch Execution","deprecated":null,"version":null,"openapi":"/api-v2.json post /batch-executions","href":"/api-reference/v2/endpoints/batch-executions/create-batch-execution"},{"title":"Get Batch Execution By Id","deprecated":null,"version":null,"openapi":"/api-v2.json get /batch-executions/id/{execution_id}","href":"/api-reference/v2/endpoints/batch-executions/get-batch-execution-by-id"},{"title":"Update Batch Execution By Id","deprecated":null,"version":null,"openapi":"/api-v2.json put /batch-executions/id/{execution_id}","href":"/api-reference/v2/endpoints/batch-executions/update-batch-execution-by-id"},{"title":"Get Batch Realtime Progress","deprecated":null,"version":null,"openapi":"/api-v2.json get /batch-executions/id/{execution_id}/realtime-progress","href":"/api-reference/v2/endpoints/batch-executions/get-batch-realtime-progress"},{"title":"Retry Failed Items","deprecated":null,"version":null,"openapi":"/api-v2.json post /batch-executions/id/{execution_id}/retry-failed","href":"/api-reference/v2/endpoints/batch-executions/retry-failed-items"},{"title":"Cancel Batch Execution","deprecated":null,"version":null,"openapi":"/api-v2.json post /batch-executions/id/{execution_id}/cancel","href":"/api-reference/v2/endpoints/batch-executions/cancel-batch-execution"}]}]},{"group":"Execution policies","pages":[{"title":"List Execution Policies","deprecated":null,"version":null,"openapi":"/api-v2.json get /execution-policies","href":"/api-reference/v2/endpoints/execution-policies/list-execution-policies"},{"title":"Create Execution Policy","deprecated":null,"version":null,"openapi":"/api-v2.json post /execution-policies","href":"/api-reference/v2/endpoints/execution-policies/create-execution-policy"},{"title":"Get Execution Policy","deprecated":null,"version":null,"openapi":"/api-v2.json get /execution-policies/{policy_id}","href":"/api-reference/v2/endpoints/execution-policies/get-execution-policy"},{"title":"Update Execution Policy","deprecated":null,"version":null,"openapi":"/api-v2.json put /execution-policies/{policy_id}","href":"/api-reference/v2/endpoints/execution-policies/update-execution-policy"},{"title":"Delete Execution Policy","deprecated":null,"version":null,"openapi":"/api-v2.json delete /execution-policies/{policy_id}","href":"/api-reference/v2/endpoints/execution-policies/delete-execution-policy"}]},{"group":"Confidence scoring","pages":[{"title":"List scoring jobs","deprecated":null,"version":null,"openapi":"/api-v2.json get /confidence-scoring/jobs","href":"/api-reference/v2/endpoints/confidence-scoring/list-scoring-jobs"},{"title":"Get a scoring job","deprecated":null,"version":null,"openapi":"/api-v2.json get /confidence-scoring/job/{job_id}","href":"/api-reference/v2/endpoints/confidence-scoring/get-a-scoring-job"},{"title":"Get agent scoring summary","deprecated":null,"version":null,"openapi":"/api-v2.json get /confidence-scoring/summary/agent/{agent_name}","href":"/api-reference/v2/endpoints/confidence-scoring/get-agent-scoring-summary"},{"title":"Get agent session scoring summary","deprecated":null,"version":null,"openapi":"/api-v2.json get /confidence-scoring/summary/agent/{agent_name}/session/{session_id}","href":"/api-reference/v2/endpoints/confidence-scoring/get-agent-session-scoring-summary"}]},{"group":"Metadata model catalog","pages":[{"title":"List Metadata Model Catalog","deprecated":null,"version":null,"openapi":"/api-v2.json get /metadata-model-catalog","href":"/api-reference/v2/endpoints/metadata-model-catalog/list-metadata-model-catalog"},{"title":"Get Metadata Model Catalog Entry","deprecated":null,"version":null,"openapi":"/api-v2.json get /metadata-model-catalog/{model_id}","href":"/api-reference/v2/endpoints/metadata-model-catalog/get-metadata-model-catalog-entry"}]}]}]}]},"basePath":"","title":"Create Batch Definition - Meibel","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}