Research workspaces

Queue verification of uploaded project files

Send an empty JSON object after every segment has been uploaded. A 202 response means verification is queued or still running. Poll the transfer until state is committed or abandoned. Repeating finalize returns 200 only once the transfer is committed. Verification checks the archive, inventory and unchanged replacement revision before publishing saved files.

post/v1/research-workspaces/{id}/transfers/{transfer}/finalize

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.

Request body

object required

Response

Files committed

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.