Complete a scan's upload

post

https://platform.reactvision.xyz/functions/v1/vps/scans/{scan_id}/upload/complete

Secret key only. Scope: vps.

Also accepts a user token.

No body. Checks that the recording is stored at the admitted size and moves the scan to queued. A scan already past awaiting_upload is answered as it is, so the device, a retry and the platform may all finish the same upload.

When nothing calls it, because the app was killed after its PUT or the user token expired during a long upload, the platform queues the scan within a minute of its recording landing at the admitted size.

Not counted against the monthly API request quota.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

`MISSING_PROJECT_ID`: no `x-project-id` header.

`INVALID_PROJECT_ID`: `x-project-id` is not a UUID.

`INVALID_APP_USER_ID`: `x-app-user-id` is not 1 to 255 printable ASCII characters without spaces, or is `.` or `..`.

`RECORDING_SIZE_MISMATCH`: the stored zip is not `recording_bytes`. It was removed and the admission released: start the upload again, from the zip.

`MISSING_API_KEY`: no `x-api-key` header and no user token.

`INVALID_API_KEY_FORMAT`: the key is not `rv_live_`, `rv_client_` or `rv_secret_` followed by 64 lowercase hexadecimal characters.

`INVALID_SESSION_FORMAT`: the `Authorization` header is not `Bearer` followed by a user token.

`INVALID_API_KEY`: no such key, or a key sent with the wrong prefix for its type.

`API_KEY_EXPIRED`: the key is past its expiry date.

`INVALID_APP_USER_TOKEN`: the user token is not valid, or the secret key that minted it has been deleted or has expired.

`APP_USER_TOKEN_EXPIRED`: the user token has expired. Get a new one from your backend.

`INVALID_SESSION`: a Bearer token that is neither a user token nor a ReactVision Editor session.

Complete a scan's upload

`NOT_FOUND`: no such scan, or one the request cannot see.

`RECORDING_NOT_UPLOADED`: the upload was never admitted, or nothing is stored yet. Start the upload and PUT the zip first.

`RATE_LIMITED`: for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in `Retry-After`. See Limits.

`INTERNAL_ERROR`: an unexpected error. Retry, and quote `meta.request_id` to support if it persists.

`AUTH_UNAVAILABLE`: the key or user token could not be checked. Retry; this does not mean it is invalid.

`VPS_LOOKUP_FAILED`: the records could not be read or written. Retry.

200The scan.

404NOT_FOUND: no such scan, or one the request cannot see.

409RECORDING_NOT_UPLOADED: the upload was never admitted, or nothing is stored yet. Start the upload and PUT the zip first.

429RATE_LIMITED: for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in Retry-After. See Limits.

500INTERNAL_ERROR: an unexpected error. Retry, and quote meta.request_id to support if it persists.

503AUTH_UNAVAILABLE: the key or user token could not be checked. Retry; this does not mean it is invalid. VPS_LOOKUP_FAILED: the records could not be read or written. Retry.

`NOT_FOUND`: no such scan, or one the request cannot see.

`RECORDING_NOT_UPLOADED`: the upload was never admitted, or nothing is stored yet. Start the upload and PUT the zip first.

`RATE_LIMITED`: for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in `Retry-After`. See Limits.

`INTERNAL_ERROR`: an unexpected error. Retry, and quote `meta.request_id` to support if it persists.

`AUTH_UNAVAILABLE`: the key or user token could not be checked. Retry; this does not mean it is invalid.

`VPS_LOOKUP_FAILED`: the records could not be read or written. Retry.