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
- 200
- 401
- 404
- 409
- 429
- 500
- 503
Accepted (or already accepted) Search outcome
Unauthorized
No direct-upload attempt with this ID for the authenticated owner.
upload_original_missing, upload_original_invalid or upload_attempt_closed.
Existing processing admission is saturated; retry later with the same attempt.
Internal server error
Disabled (upload_grants_disabled) or an unavailable store/image server (upload_grants_unavailable).