You are currently browsing legacy 3.0 version of documentation. Click here to switch to the newest 5.0 version.

We can help you with migration to the latest RavenDB

Contact Us Now
see on GitHub

Commands: UpdateMetadata

The POST operation is used if you need to change just the file's metadata without any modification to its content.

Syntax

curl \
	http://{serverUrl}/fs/{fileSystemName}/files/{name}  \
	-X POST \
    --header "Content-Length:0"
	--header "anyKey:anyValue" \
    --header "If-None-Match:{etag}"

Request

Payload
Empty
Query parameter Required Description
name Yes The name of modified file
Header Required Description
Content-Length Yes Needed to accomplish the POST request
If-None-Match No Used to pass the file Etag
Any other header No Used to pass metadata records

Response

Status code Description
204 No Content status means that operation completed successfully
405 The concurrency exception occurred
420 The synchronization exception occurred
Return Value Description
None The request does not return any message

Example

In order to change metadata of /movies/intro.avi by setting AllowRead to None value, create the POST request as follow:

curl \
	-X POST http://localhost:8080/fs/NorthwindFS/files/movies/intro.avi  \
	--header "Content-Length:0" \
    --header "AllowRead:None"
< HTTP/1.1 204 NoContent