Invalidate upload URL

This endpoint invalidates the temporary upload URL. You will not be able to upload Docs or files for batch operation files via this URL after it has been invalidated.

IMPORTANT NOTE

• If a Doc was uploaded through the upload URL, but was not attached to a Twin through the attach_twin_doc endpoint, it will be deleted after the upload URL has been invalidated.
• If a batch operation file was uploaded through the upload URL, but no request was submitted through the create_batch endpoint, it will be deleted after the upload URL has been invalidated.

Method	Path	Operation*
DELETE	/cache/{handler}	invalidate_upload_url

*

In order for a user to perform the "invalidate_upload_url" operation, the "invalidate_upload_url" permission must be included in the list of allowed actions in the statement of the user's role.

Request

Parameter	Type	In	Description
{handler} required	string	path	URL handler generated through the create_upload_url endpoint. It is used in the attach_twin_doc endpoint to attach a Doc to a Twin and to store the Doc in the Twin's directory.

In our example, we invalidate the upload URL with the handler 128ba3ce-a0ea-47c7-a487-3a8531fc3312.

Response

Attribute	Type	Description
handler	string	URL handler generated through the create_upload_url endpoint. It is used in the attach_twin_doc endpoint to attach a Doc to a Twin and to store the Doc in the Twin's directory.

The response returns the handler of the invalidated upload URL.

Status codes

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.