Upload file to batch

Upload a file to a batch or update the contents of a previously uploaded file in a batch.

Files can be uploaded one at a time and the suggested max size for each file is 10 MB. For larger files, see Multipart file upload.

If you upload a password-protected PDF, provide the password when you process the PDF with an AI Hub app. See instructions for configuring the settings.runtime_config.instabase.pdf.passwords property for the Run deployment or Run app operations.

Upload a file to a batch or update the contents of a previously uploaded file in a batch. <Info>Files can be uploaded one at a time and the suggested max size for each file is 10 MB. For larger files, see [Multipart file upload](/api-sdk/multipart-upload/).</Info> <Note>If you upload a password-protected PDF, provide the password when you process the PDF with an AI Hub app. See instructions for configuring the `settings.runtime_config.instabase.pdf.passwords` property for the [Run deployment](/api-sdk/api-reference/runs/run-deployment#request.body.settings.runtime_config.instabase.pdf.passwords) or [Run app](/api-sdk/api-reference/runs/run-app#request.body.settings.runtime_config.instabase.pdf.passwords) operations.</Note>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

batch_idintegerRequired

The batch ID.

filenamestringRequired

A user-defined name for the file. Include the file extension.

Headers

IB-ContextstringOptional

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See Authorization and context identification for details.

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See [Authorization and context identification](/api-sdk/authorization#ib-context-header) for details.

1	curl -X PUT "${API_ROOT}/v2/batches/<BATCH-ID>/files/<FILENAME>" \
2	-H "Authorization: Bearer ${API_TOKEN}" \
3	-H "IB-Context: ${IB_CONTEXT}" \
4	-H "Content-Type: application/octet-stream" \
5	--upload-file '<LOCAL_FILEPATH>' # Full path to the file in the machine that's making the request

Authentication

Path parameters

Headers

Request

Response

Errors