# Invalidate an upload URL

This endpoint invalidates the temporary upload URL. You will not be able to upload a Doc via this upload URL after it has been invalidated.

IMPORTANT NOTE

If a Doc was uploaded through the upload URL, but was not attached to the Twin through the attach_twin_doc 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 the Doc to a Twin and to store it in the Twin's directory.

In our example, we want to 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 the Doc to a Twin and to store it 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.