OpenAI API (unofficial showcase)
POST/uploads/{upload_id}/parts

Add a part to an upload

Adds a chunk of file bytes as a part of an existing upload. Send the chunk in the data field; each part can be at most 64 MB, and the upload can contain up to 8 GB in total. You can add parts in parallel and specify their order when you complete the upload.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
upload_idstringrequired
The ID of the upload to add this part to.

Multipart form data containing the bytes for one upload part.

datastringrequired
The chunk of bytes for this Part.

6 status codes
200Returns the created upload part, including its identifier, creation timestamp, upload ID, and object type.
idstringrequired
The upload Part unique identifier, which can be referenced in API endpoints.
created_atintegerrequired
The Unix timestamp (in seconds) for when the Part was created.
upload_idstringrequired
The ID of the Upload object that this Part was added to.
objectstringrequired
The object type, which is always `upload.part`.
Allowed:upload.part
400Returned when the upload cannot accept more parts or the part exceeds an upload size limit.
errorobjectrequired
404Returned when the upload was not found.
errorobjectrequired
410Returned when the upload has expired; create a new upload before adding parts or completing it.
errorobjectrequired
429Returned when there are too many upload requests; reduce the request rate and try again later.
errorobjectrequired
500Returned when the part could not be uploaded; retry the request.
errorobjectrequired

Error handling

A 400 is returned when the upload cannot accept more parts or the part exceeds a size limit. A 404 is returned when the upload is not found, and a 410 is returned when the upload has expired; create a new upload before adding parts. A 429 indicates too many upload requests, and a 500 indicates the part could not be uploaded. The upload_id path parameter must identify an active upload, and data must contain a part no larger than 64 MB.