Research workspaces

Read upload and verification progress

Read state and uploaded_segments before resuming an interrupted upload. A committed transfer has replaced the guarded saved-file revision. Queued or verifying does not establish a successful save. Requires stopped compute and the active workspace storage policy.

get/v1/research-workspaces/{id}/transfers/{transfer}

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Workspace identifier owned by this account.

transferstring uuid required

Transfer identifier returned by begin.

Response

Current transfer state

idstring uuid required
workspace_idstring required
failure_codestring

Recorded verification failure when present. Inspect state before retrying or beginning a replacement transfer.

state'uploading' | 'queued' | 'verifying' | 'committed' | 'abandoned' required
base_revisioninteger required
manifest_sha256string required
manifest_bytesinteger required
uploaded_segmentsinteger[] required

Zero-based indexes already verified for this transfer. Empty when no segment is present.

Changes

No recorded changes to this operation across all 70 revisions of this API.