Skip to main content

Accept a directly uploaded original and start the Search

POST 

/search/:searchId/upload-complete

Completes a pending direct-upload attempt created by POST /search/upload-grant, off by default together with that operation. The caller must be the attempt owner under the same authentication rules as the grant (persisted canonical account session, or app guest with the valid app selector). The request has no body: the backend reads the original from its own image-server location, verifies the frozen size and sha256 plus image decode limits, and only the committed winner starts processing. Repeating the call after acceptance returns the same outcome without another reservation, charge or processing start. 409 upload_original_missing means the image server has no stored original yet (retry briefly, then upload again); 409 upload_original_invalid means the stored bytes can never be accepted (start a new attempt with a new Idempotency-Key); 409 upload_attempt_closed means the attempt is rejected, expired or deleted. When disabled, 503 has GeneralError.message upload_grants_disabled.

Request​

Responses​

Accepted (or already accepted) Search outcome