A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.
Every batch run on Impala is served by a job. Passing a job_id is optional. Without one, Impala picks the job for you, based on the model you request and your agreement with us.
What a job is
A job is a model plus a configuration, provisioned for your account and identified by a job_id that looks like job-xxxxxxxx.The configuration is the part that matters for throughput: which model weights are loaded, how they’re quantized, what hardware shape they run on, and how the scheduler treats the workload. Impala provisions a job for you rather than having you assemble those choices per request, which is how a batch run reaches its cost per token.Practically, this means:
You don’t pick a model and a machine type at request time. You name the model, and optionally a job.
Two jobs can serve the same model with different configurations.
A model that isn’t provisioned for your account can’t be batched yet. Ask your Impala contact to provision it.
Some models have separate reasoning and standard jobs. Others serve both from one job and switch per request. See Reasoning.
The Run tab in the Impala console lists every job ID available to your workspace, with one-click copy. That list is the definitive answer to “what can we run” — not the model catalog in the Playground, which exists for exploration and does not imply batch availability.
Using a job ID
Pass job_id when you want a specific configuration, for example to choose between two jobs that serve the same model. Leave it out and Impala routes the batch for you.To pin a job, pass job_id when you create the batch:
If job_id names no job, the create call still succeeds, but the batch fails when Impala routes it. Its errors.data carries the code workload_resolution_rejected and the message Job not found: <job_id>. Copy job IDs from the Run tab to avoid this.
The model has to match
Every line of your JSONL carries a model field. If you pass a job_id, it must name the same model the job is bound to.
If body.model and the job’s model disagree, the request fails. Two habits that prevent it:
Generate the JSONL from a single constant rather than typing the model name per line.
Keep one job ID per pipeline, so the pairing lives in one place in your config.
url in each line must also match the endpoint you passed when creating the batch.
Need help?
Reach out to your Impala contact directly.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Impala AI Documentation","colors":{"primary":"#2563eb","light":"#7aa7f5","dark":"#1d4ed8"},"logo":{"light":"https://mintcdn.com/impalaai/56GIWcAxVIuqqB4N/LOGO.png?fit=max\u0026auto=format\u0026n=56GIWcAxVIuqqB4N\u0026q=85\u0026s=bfa04414e9e206d4d746cb5c14c65b64","dark":"https://mintcdn.com/impalaai/iKjilE4KzmFvYW-p/LOGO-LIGHT.png?fit=max\u0026auto=format\u0026n=iKjilE4KzmFvYW-p\u0026q=85\u0026s=89996dfd863a19b2b7f3e1a23d3cd900"},"favicon":"https://mintcdn.com/impalaai/CT_7X33viTgR4c3n/favicon-flipped.png?fit=max\u0026auto=format\u0026n=CT_7X33viTgR4c3n\u0026q=85\u0026s=3274696fdf43018c47e87fe4465d6453","background":{"decoration":"gradient"},"navbar":{"links":[{"href":"/changelog","label":"Product updates"},{"href":"https://www.getimpala.ai/blog","label":"Blog"},{"href":"mailto:orel@getimpala.ai","label":"Support"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/impala-ai","website":"https://www.getimpala.ai/"}},"fonts":{"family":"rethink sans"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"impalaai","hasAudioNarration":false,"actualSubdomain":"impalaai","customDomains":["docs.getimpala.ai"],"gitSource":{"type":"github","owner":"orel-impala","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af9ac18dc65debd1bc21b1b","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":11},{"language":"default","tag":"Files","count":5},{"language":"default","tag":"Introduction","count":4},{"language":"default","tag":"Serverless inference","count":4},{"language":"default","tag":"Batch inference","count":4},{"language":"default","tag":"Batches","count":4},{"language":"default","tag":"Bring your own cloud (BYOC)","count":3},{"language":"default","tag":"Reference","count":3},{"language":"default","tag":"Bring your own model","count":3},{"language":"default","tag":"Integrations","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"site-roles","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":"jobs-and-job-ids","slug":"/jobs-and-job-ids","pageMetadata":{"title":"Jobs","description":"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.","href":"/jobs-and-job-ids"},"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: \"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every batch run on Impala is served by a `,_jsx(_components.strong,{children:`job`}),`. Passing a `,_jsx(_components.code,{children:`job_id`}),` is optional. Without one, Impala picks the job for you, based on the model you request and your agreement with us.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-a-job-is`,children:`What a job is`}),`\n`,_jsxs(_components.p,{children:[`A job is a `,_jsx(_components.strong,{children:`model plus a configuration`}),`, provisioned for your account and identified by a `,_jsx(_components.code,{children:`job_id`}),` that looks like `,_jsx(_components.code,{children:`job-xxxxxxxx`}),`.`]}),`\n`,_jsx(_components.p,{children:`The configuration is the part that matters for throughput: which model weights are loaded, how they’re quantized, what hardware shape they run on, and how the scheduler treats the workload. Impala provisions a job for you rather than having you assemble those choices per request, which is how a batch run reaches its cost per token.`}),`\n`,_jsx(_components.p,{children:`Practically, this means:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`You don’t pick a model and a machine type at request time. You name the model, and optionally a job.`}),`\n`,_jsx(_components.li,{children:`Two jobs can serve the same model with different configurations.`}),`\n`,_jsx(_components.li,{children:`A model that isn’t provisioned for your account can’t be batched yet. Ask your Impala contact to provision it.`}),`\n`,_jsxs(_components.li,{children:[`Some models have separate reasoning and standard jobs. Others serve both from one job and switch per request. See `,_jsx(_components.a,{href:`/send-a-request#reasoning`,children:`Reasoning`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A job can include your own `,_jsx(_components.a,{href:`/lora-adapters`,children:`LoRA adapter`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`finding-your-job-ids`,children:`Finding your job IDs`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Run`}),` tab in the Impala console lists every job ID available to your workspace, with one-click copy. That list is the definitive answer to “what can we run” — not the model catalog in the Playground, which exists for exploration and does not imply batch availability.`]}),`\n`,_jsx(Heading,{level:`2`,id:`using-a-job-id`,children:`Using a job ID`}),`\n`,_jsxs(_components.p,{children:[`Pass `,_jsx(_components.code,{children:`job_id`}),` when you want a specific configuration, for example to choose between two jobs that serve the same model. Leave it out and Impala routes the batch for you.`]}),`\n`,_jsxs(_components.p,{children:[`To pin a job, pass `,_jsx(_components.code,{children:`job_id`}),` when you create the batch:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$BASE_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/batches\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"input_file_id\": \"file-abc123\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"endpoint\": \"/v1/chat/completions\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"completion_window\": \"unlimited\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"job_id\": \"job-xxxxxxxx\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The OpenAI SDK has no `,_jsx(_components.code,{children:`job_id`}),` parameter, so pass it through `,_jsx(_components.code,{children:`extra_body`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`batch `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.batches.create(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` input_file_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:`file`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.id,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` endpoint`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/v1/chat/completions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` completion_window`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unlimited\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` extra_body`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"job_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"job-xxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`job_id`}),` names no job, the create call still succeeds, but the batch fails when Impala routes it. Its `,_jsx(_components.code,{children:`errors.data`}),` carries the code `,_jsx(_components.code,{children:`workload_resolution_rejected`}),` and the message `,_jsx(_components.code,{children:`Job not found: \u003cjob_id>`}),`. Copy job IDs from the `,_jsx(_components.strong,{children:`Run`}),` tab to avoid this.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-model-has-to-match`,children:`The model has to match`}),`\n`,_jsxs(_components.p,{children:[`Every line of your JSONL carries a `,_jsx(_components.code,{children:`model`}),` field. If you pass a `,_jsx(_components.code,{children:`job_id`}),`, it must name the same model the job is bound to.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"custom_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/v1/chat/completions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"messages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:[{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}]}}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`body.model`}),` and the job’s model disagree, the request fails. Two habits that prevent it:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Generate the JSONL from a single constant rather than typing the model name per line.`}),`\n`,_jsx(_components.li,{children:`Keep one job ID per pipeline, so the pairing lives in one place in your config.`}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`url`}),` in each line must also match the `,_jsx(_components.code,{children:`endpoint`}),` you passed when creating the batch.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`need-help`,children:`Need help?`}),`\n`,_jsx(_components.p,{children:`Reach out to your Impala contact directly.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Jobs","description":"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.","href":"/jobs-and-job-ids"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What a job is","slug":"what-a-job-is","depth":2,"children":[]},{"title":"Finding your job IDs","slug":"finding-your-job-ids","depth":2,"children":[]},{"title":"Using a job ID","slug":"using-a-job-id","depth":2,"children":[]},{"title":"The model has to match","slug":"the-model-has-to-match","depth":2,"children":[]},{"title":"Need help?","slug":"need-help","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"impalaai","siteName":"Impala AI Documentation","title":"Jobs - Impala AI Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T12:52:20.185Z","originalFileLocation":"jobs-and-job-ids.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=\"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Impala AI Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/impalaai/U-hxjL9MrmCEu7hF/_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/impalaai/U-hxjL9MrmCEu7hF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/impalaai/U-hxjL9MrmCEu7hF/_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/impalaai/U-hxjL9MrmCEu7hF/_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/impalaai/U-hxjL9MrmCEu7hF/_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/impalaai/U-hxjL9MrmCEu7hF/_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/impalaai/U-hxjL9MrmCEu7hF/_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/impalaai/U-hxjL9MrmCEu7hF/_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/impalaai/U-hxjL9MrmCEu7hF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Jobs - Impala AI Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Impala AI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getimpala.ai/jobs-and-job-ids\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://impalaai.mintlify.site/_mintlify/api/og/v2?division=Batch+inference\u0026amp;title=Jobs\u0026amp;description=A+job+is+a+model+plus+a+configuration%2C+provisioned+for+your+account.+Passing+a+job+ID+is+optional%3B+without+one%2C+Impala+picks+the+job+for+you.\u0026amp;theme=6b61ed0062b27ba13c4e93e6\u0026amp;signature=142468f795d005b3a9c246db54499c708564727cfddff9b94db5439ea9fd0a54\">\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=\"Jobs - Impala AI Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://impalaai.mintlify.site/_mintlify/api/og/v2?division=Batch+inference\u0026amp;title=Jobs\u0026amp;description=A+job+is+a+model+plus+a+configuration%2C+provisioned+for+your+account.+Passing+a+job+ID+is+optional%3B+without+one%2C+Impala+picks+the+job+for+you.\u0026amp;theme=6b61ed0062b27ba13c4e93e6\u0026amp;signature=142468f795d005b3a9c246db54499c708564727cfddff9b94db5439ea9fd0a54\">\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/impalaai/U-hxjL9MrmCEu7hF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Impala AI Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getimpala.ai/jobs-and-job-ids\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/jobs-and-job-ids.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getimpala.ai/#organization\",\"name\":\"Impala AI Documentation\",\"url\":\"https://docs.getimpala.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/impalaai/56GIWcAxVIuqqB4N/LOGO.png?fit=max\u0026auto=format\u0026n=56GIWcAxVIuqqB4N\u0026q=85\u0026s=bfa04414e9e206d4d746cb5c14c65b64\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getimpala.ai#website\",\"name\":\"Impala AI Documentation\",\"url\":\"https://docs.getimpala.ai\",\"publisher\":{\"@id\":\"https://docs.getimpala.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getimpala.ai/jobs-and-job-ids#webpage\",\"url\":\"https://docs.getimpala.ai/jobs-and-job-ids\",\"name\":\"Jobs\",\"description\":\"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.\",\"dateModified\":\"2026-11-15T12:52:20.185Z\",\"isPartOf\":{\"@id\":\"https://docs.getimpala.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getimpala.ai/jobs-and-job-ids#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getimpala.ai/jobs-and-job-ids#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Batch inference\",\"item\":\"https://docs.getimpala.ai/run-your-first-batch\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Jobs\",\"item\":\"https://docs.getimpala.ai/jobs-and-job-ids\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.getimpala.ai/jobs-and-job-ids#article\",\"headline\":\"Jobs\",\"name\":\"Jobs\",\"description\":\"A job is a model plus a configuration, provisioned for your account. Passing a job ID is optional; without one, Impala picks the job for you.\",\"url\":\"https://docs.getimpala.ai/jobs-and-job-ids\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getimpala.ai/jobs-and-job-ids#webpage\"},\"dateModified\":\"2026-11-15T12:52:20.185Z\",\"publisher\":{\"@id\":\"https://docs.getimpala.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getimpala.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Impala AI Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Impala AI Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/jobs-and-job-ids.md","siteName":"Impala AI Documentation","nav":{"global":null,"groups":[{"group":"Introduction","icon":"compass","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Run async and open source","href":"/async-inference"},{"title":"Completion windows","href":"/completion-windows"},{"title":"Run in our cloud, or yours","href":"/deployment-options"}]},{"group":"Serverless inference","icon":"bolt","pages":[{"title":"Quickstart","href":"/impala-cloud-setup"},{"title":"Chat completions","href":"/send-a-request"},{"title":"Rate limit webhooks","href":"/rate-limit-webhooks"},{"title":"Billing API","href":"/billing-api"}]},{"group":"Batch inference","icon":"layer-group","pages":[{"title":"Run a batch","description":"This guide shows how to submit batch inference to your Impala endpoint using the OpenAI-compatible API. You’ll upload an input file, then create a batch.","href":"/run-your-first-batch"},{"title":"Jobs","href":"/jobs-and-job-ids"},{"title":"Images","description":"Send images to batch chat-completion requests by S3 reference instead of inline base64.","href":"/pass_images_with_image_url"},{"title":"Video","href":"/video-input"}]},{"group":"Agent orchestration","icon":"sitemap","pages":[{"title":"Impala Swarm","href":"/swarm"}]},{"group":"Optimization","icon":"gauge","pages":[{"title":"Impala Herd","href":"/impala-herd"}]},{"group":"Bring your own model","icon":"cube","pages":[{"title":"LoRA adapters","href":"/lora-adapters"},{"title":"LoRA adapters in batch","href":"/lora-batch"},{"title":"Impala Leap","href":"/weight-sync"}]},{"group":"Bring your own cloud (BYOC)","icon":"cloud","pages":[{"title":"Install Impala in your VPC","href":"/getting-started-infrastructure-setup"},{"title":"Expose the OpenAI API endpoint","href":"/exposing_the_openai_api_endpoint_service"},{"title":"Raise AWS service quotas","href":"/aws_service_quotas_for_Impala_data_plane_deployment"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"LiteLLM","href":"/connect-litellm"},{"title":"Anthropic SDKs and Claude Code","href":"/anthropic-sdk"}]},{"group":"Reference","icon":"book","pages":[{"title":"Security \u0026 data handling","href":"/security"},{"title":"Further reading","href":"/further-reading"},{"title":"Glossary","href":"/glossary"}]},{"group":"API reference","icon":"code","pages":[{"group":"System","pages":[{"title":"Health","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json get /health","href":"/api-reference/system/health"},{"title":"Ready","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json get /ready","href":"/api-reference/system/ready"}]},{"group":"Files","pages":[{"title":"List Files","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json get /v1/files","href":"/api-reference/files/list-files"},{"title":"Upload File","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json post /v1/files","href":"/api-reference/files/upload-file"},{"title":"Get File","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json get /v1/files/{file_id}","href":"/api-reference/files/get-file"},{"title":"Delete File","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json delete /v1/files/{file_id}","href":"/api-reference/files/delete-file"},{"title":"Get File Content","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json get /v1/files/{file_id}/content","href":"/api-reference/files/get-file-content"}]},{"group":"Batches","pages":[{"title":"List Batches","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json get /v1/batches","href":"/api-reference/batches/list-batches"},{"title":"Create Batch","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json post /v1/batches","href":"/api-reference/batches/create-batch"},{"title":"Get Batch","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json get /v1/batches/{batch_id}","href":"/api-reference/batches/get-batch"},{"title":"Cancel Batch","deprecated":null,"version":null,"openapi":"/openai-api-swagger.json post /v1/batches/{batch_id}/cancel","href":"/api-reference/batches/cancel-batch"}]}]}]},"basePath":"","title":"Jobs - Impala AI Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}