molgenis
Latest
Search
K

Files api

The Files API allows you do upload/download files.

Upload file

Request

POST /api/files
...binary data in the body...

Request Headers

Name
Description
Required
Default value
Content-Type *
A standard MIME type describing the format of the file
No
application/octet-stream
Content-Length
File size in bytes
No
x-molgenis-filename
Filename
No
unknown
x-molgenis-token
Authentication token
No
session cookie if supplied
  • All media types with the exception of application/x-www-form-urlencoded and multipart/form-data are allowed. See the JavaScript example for how to upload a file from a form file input.
    Response
    Status code
    Description
    201 Created
    File uploaded and file metadata created.
    403 Forbidden
    If the authenticated user does not have WRITE permissions on file metadata.

Response Headers

Name
Description
Location
Location of a newly created resource

Response body

Filemeta as returned by the 'Retrieve file metadata' endpoint.

Examples

JavaScript

var file = document.getElementById('my-file-input').files[0]
var request = new XMLHttpRequest()
request.open('post', '/api/files', true)
request.setRequestHeader("Content-Type", file.type)
request.setRequestHeader("Content-Length", file.size)
request.setRequestHeader("x-molgenis-filename", file.name)
request.send(file)

cURL

curl -H 'Content-Type: application/octet-stream' --data-binary @my.file /api/files

Download file

Request

GET /api/files/myFileId?alt=media

Response

Status code
Description
200 OK
File downloaded
403 Forbidden
If the authenticated user does not have READ permissions on the file metadata
404 Not Found
If the file identifier is unknown

Retrieve file metadata

Request

GET /api/files/myFileId

Response

Status code
Description
200 OK
File metadata
403 Forbidden
If the authenticated user does not have READ permissions on the file metadata

Response body

Example:
{
"id": "aaaac2mp6yoxgaavluayxfiaae",
"filename": "logo_green.png",
"contentType": "image/png",
"size": 11189,
}

Delete file

Request

DELETE /api/files/myFileId

Response

Status code
Description
204 No Content
File and filemeta deleted.
403 Forbidden
If the authenticated user does not have WRITE permissions on the file metadata
404 Not Found
If the file identifier is unknown