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

We can help you with migration to the latest RavenDB

Contact Us Now
see on GitHub

Attachments: Get

There are few methods that allow you to download attachments from a database:
- GetAttachment
- GetAttachments

GetAttachment

GetAttachment can be used to download a single attachment.

Syntax

curl \
	http://{serverName}/databases/{databaseName}/static/{key} \
	-X GET

Request

Query parameter Required Description
key Yes key of the attachment you want to download

Response

Status code Description
200 OK
Return Value Description
payload attachment stream
Header Description
ETag attachment ETag
any header metadata

Example

curl -X GET "http://localhost:8080/databases/sample/static/sea.jpg" 

< HTTP/1.1 200 OK
< ETag: "02000000-0000-0002-0000-000000000001"
< Description: Holidays 2014
here goes payload

GetAttachments

GetAttachments can be used to download attachment information for multiple attachments.

Syntax

curl \
	http://{serverName}/databases/{databaseName}/static/? \
		&pageSize={pageSize} \
		&etag={etag} \
		&start={start} \
	-X GET

Request

Query parameter Required Description
start Yes Indicates how many attachments should be skipped
etag Yes ETag from which to start
pageSize Yes maximum number of attachments that will be downloaded

Response

Status code Description
200 OK
Return Value Description
payload list of AttachmentInformation

Example

curl -X GET "http://localhost:8080/databases/sample/static/?pageSize=128&etag=00000000-0000-0000-0000-000000000000&start=0"
< HTTP/1.1 200 OK
[
	{
		"Size":4,
		"Key":"sea.jpg",
		"Metadata":{"Description":"Holidays 2014","Content-Type":"application/json; charset=UTF-8"},
		"Etag":"02000000-0000-0002-0000-000000000001"
	},
	... another attachment information ...
]