PUT/<upload_url>

Upload a batch inference input file

Uploads raw JSONL bytes to the presigned URL returned by POST /v1/batches/files. Use the returned upload_url verbatim and send the bytes as application/octet-stream or omit Content-Type to avoid signature mismatches. The upload must complete before POST /v1/batches checks the object with a HEAD request.

6 status codes
200Returns confirmation that object storage accepted the upload.
401Returned when authentication fails because the credentials are invalid.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
403Returned when the URL signature does not match the request or the presigned URL has expired. Create a new file intent with `POST /v1/batches/files` and upload again.
429Returned when the API rate limit has been exceeded.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
500Returned when a server error occurs.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
defaultThere was an unexpected error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.

Error handling

A 401 is returned when credentials are invalid, and a 403 when the presigned URL signature mismatches or the URL expires; create a new file intent with POST /v1/batches/files and upload again. A 429 indicates the API rate limit was exceeded, and a 500 indicates a server error; send the raw JSONL bytes with Content-Type: application/octet-stream or omit the header to avoid signature mismatches.