Delete a file

delete

https://platform.reactvision.xyz/functions/v1/assets/{asset_id}

Secret key only.

Deletes a file record and its stored file. The cloud anchors it is attached to and the geospatial anchors linked to it are deleted with it. Deletion is permanent.

An id your key cannot reach (another team's, or another project's for a bound key) gets the same answer as an id that does not exist.

Not counted against the monthly API request quota.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

`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.

`API_KEY_TYPE_NOT_ALLOWED`: a client key or a legacy key. This operation needs a secret key.

`ASSET_NOT_FOUND`: no such file, or one the key cannot reach.

`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.

`DELETE_FAILED`: the file could not be deleted.

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

`API_KEY_LOOKUP_FAILED`: the key could not be checked. Retry; this does not mean the key is invalid.

Language

Credentials

Header

Loading…

Response

Choose an example:

application/json

200Deleted.

403API_KEY_TYPE_NOT_ALLOWED: a client key or a legacy key. This operation needs a secret key.

404ASSET_NOT_FOUND: no such file, or one the key cannot reach.

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.

500DELETE_FAILED: the file could not be deleted. INTERNAL_ERROR: an unexpected error. Retry, and quote meta.request_id to support if it persists.

503API_KEY_LOOKUP_FAILED: the key could not be checked. Retry; this does not mean the key is invalid.

`API_KEY_TYPE_NOT_ALLOWED`: a client key or a legacy key. This operation needs a secret key.

`ASSET_NOT_FOUND`: no such file, or one the key cannot reach.

`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.

`DELETE_FAILED`: the file could not be deleted.

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

`API_KEY_LOOKUP_FAILED`: the key could not be checked. Retry; this does not mean the key is invalid.