Skip to main content

Download a file

GET /projects/:projectid/library/files/:fileid/download

Redirects to a signed download URL.

Responds with a 302 to a short-lived storage URL. Most HTTP clients follow it automatically; curl needs -L.

Authentication​

  • Project API key: The credential for everything external. Created in Project Settings, bound to one project, and limited to the scopes it was granted. Format: proj.<keyId>.<secret>.
  • Required permission: library.read.

Path parameters​

NameTypeRequiredDefaultDescription
projectidstringYes-The project id.
fileidstringYes-The file id, from List files.

Example request​

curl -L -X GET \
-H "Authorization: proj.KEY_ID.SECRET" \
{{BASE_URL}}/projects/{{PROJECT_ID}}/library/files/FILE_ID/download

Responses​

302​

Redirect to the file contents.

400​

No file id given.