get_upload_session
curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/upload-sessions/{session_id} \
--header 'X-Upload-Token: <api-key>'{
"chunk_size": 123,
"declared_size_bytes": 123,
"expires_at": "2023-11-07T05:31:56Z",
"parts": [
{
"part_number": 123,
"size_bytes": 123
}
],
"received_bytes": 123,
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "open",
"total_parts": 123
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}get_upload_session
Read a chunked upload’s lifecycle state and landed parts. Cost class: fast.
The resume entry point: after a dropped connection (or a page reload),
diff parts against what was already sent and PUT only what is
missing — never re-derive part numbers, and never resend a part that
already landed.
GET
/
v1
/
workspaces
/
{workspace_id}
/
upload-sessions
/
{session_id}
get_upload_session
curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/upload-sessions/{session_id} \
--header 'X-Upload-Token: <api-key>'{
"chunk_size": 123,
"declared_size_bytes": 123,
"expires_at": "2023-11-07T05:31:56Z",
"parts": [
{
"part_number": 123,
"size_bytes": 123
}
],
"received_bytes": 123,
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "open",
"total_parts": 123
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}Authorizations
Session token from POST /v1/workspaces/{workspace_id}/upload-sessions.
Path Parameters
Workspace identifier.
Upload session identifier.
Response
Successful Response
Result of GET .../upload-sessions/{session_id} — for resuming after a drop.
A resuming client diffs parts against what it already sent and PUTs
only what is missing; it never needs to re-derive part numbers itself.
Parts landed so far, unordered.
Show child attributes
Show child attributes
Sum of parts[*].size_bytes.
Available options:
open, completing, completed, aborted