Without asset_type the upload is an image, so a client key must name anchor-features or mesh; any other type answers 403 API_KEY_TYPE_NOT_ALLOWED. The MIME type is the file part's own Content-Type. When that is application/octet-stream and the asset_type does not accept it (image and video), the type is taken from the file name's extension instead: .jpg or .jpeg, .png, .gif, .webp, .mp4, .webm or .mov.
An anchor file's response gives a url to pass to a cloud or geospatial anchor as descriptors_url, feature_points_url or mesh_url. It is deleted with the anchor that references it, and after 24 hours if no anchor does. A file record's response gives an id to attach or link as user_asset_id; it is deleted 90 days after upload.
With a client key, project_id must be the key's project. Uploads are not counted against the monthly API request quota.
Recent Requests
Log in to see full request history
Time
Status
User Agent
Retrieving recent requests…
Loading…
Responses
401
MISSING_API_KEY: no x-api-key header.
INVALID_API_KEY_FORMAT: the key is not rv_live_, rv_client_ or rv_secret_ followed by 64 lowercase hexadecimal characters.
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.
AUTH_ERROR: a user token (rv_ut_) was sent as a Bearer token. This operation does not accept user tokens.
403
API_KEY_TYPE_NOT_ALLOWED: a client key uploading an image, video or 3d-model, or sending no asset_type.
PROJECT_NOT_FOUND: project_id does not exist, belongs to another team, or is not the project the key is bound to. The three answers are the same.
STORAGE_LIMIT_REACHED: an image, video or 3d-model upload with the team's storage quota used up.
429
RATE_LIMITED: for anchor-features and mesh, more than 30 a minute from one IP address for your team; or, for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in Retry-After. See Limits.
500
UPLOAD_FAILED: the file could not be stored.
ASSET_CREATE_FAILED: the file record could not be created.
INTERNAL_ERROR: an unexpected error. Retry, and quote meta.request_id to support if it persists.
503
API_KEY_LOOKUP_FAILED: the key could not be checked. Retry; this does not mean the key is invalid.
PROJECT_LOOKUP_FAILED: the project could not be checked. Retry.