Upload one chunk of a replacement
const url = 'https://work.optidata.cloud/api/drives/1/nodes/300754/chunk/contents/613488/upload';const form = new FormData();form.append('chunkData', 'example');form.append('chunkNumber', '1');form.append('chunkHash', 'example');form.append('asBase64', 'true');form.append('name', 'example');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://work.optidata.cloud/api/drives/1/nodes/300754/chunk/contents/613488/upload \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form chunkData=example \ --form chunkNumber=1 \ --form chunkHash=example \ --form asBase64=true \ --form name=exampleSends a single chunk into the content version opened by
POST /drives/{drive}/nodes/{node}/chunk/prepare. Requires permission to
update the node’s content.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Numeric id of the drive. Read it from GET /drives/config.json.
Numeric id of the node (file or folder).
Numeric id of a stored content version of the file. Version ids come from the node history or from the chunked-update prepare step.
Request Bodyrequired
Section titled “Request Bodyrequired”One chunk of a replacement of an existing file’s content.
object
The chunk itself — raw bytes as a multipart part, or base64 when
asBase64 is set.
Position of this chunk, counting from 1.
SHA-256 of the chunk, for verification on arrival.
Set when chunkData is base64 encoded.
Original file name, kept for diagnostics.
One chunk of a replacement of an existing file’s content.
object
The chunk itself — raw bytes as a multipart part, or base64 when
asBase64 is set.
Position of this chunk, counting from 1.
SHA-256 of the chunk, for verification on arrival.
Set when chunkData is base64 encoded.
Original file name, kept for diagnostics.
Examplegenerated
{ "chunkData": "example", "chunkNumber": 1, "chunkHash": "example", "asBase64": true, "name": "example"}Responses
Section titled “ Responses ”The chunk was stored.
object
Examplegenerated
{}Missing, malformed or expired authentication key.
Authentication failures use an error key rather than message.
object
Examples
No bearer token sent
{ "error": "JWT passport exception: Missing bearer token in request"}The caller lacks the permission level the operation requires.
Generic error envelope used by policy, binding and framework failures.
object
Human-readable description of the failure.
Examples
{ "message": "This action is unauthorized."}The resource does not exist, or does not belong to the given drive.
Generic error envelope used by policy, binding and framework failures.
object
Human-readable description of the failure.
Examples
{ "message": "No query results for model [App\\Models\\Node] 99999999"}The request body or query string failed validation.
object
The first validation message.
Validation messages keyed by field name.
object
Examples
{ "message": "The name field is required.", "errors": { "name": [ "The name field is required." ] }}Rate limit exceeded. Retry after the window resets.
Generic error envelope used by policy, binding and framework failures.
object
Human-readable description of the failure.
Examples
{ "message": "Too Many Attempts."}