---
title: "Get upload url for a file"
method: GET
path: "/matters/{matterId}/documents/files/{fileId}/upload"
tags: ["Files"]
---

# Get upload url for a file

`GET /matters/{matterId}/documents/files/{fileId}/upload`

Retrieves upload details for a specified matter file.

## Path parameters

- `matterId` string, required
- `fileId` string, required

## Response `200`

When request is successful. Returns an 'UploadFileInfo' object.

- UploadFileInfo
  - `fileId` string, nullable — Unique identifier of the file.
  - `uploadUrl` string, nullable — Temporary Link to upload file. Important note: When uploading to this URL, set the 'Content-Type' header to an empty value. Example cURL: curl --location --request PUT 'URL_GOES_HERE' \ --header 'Content-Type: ""' \ --data '@/C:/dir/test.pdf'
  - `expiry` string, date-time — Expiry date/time when the upload link is no longer accessible.

## Other responses

- `403` — When the requested file does not belong to the account making the request.
- `404` — When file or matter with the specified id does not exist.

---

[API](https://skmtc.net/smokeball/apis/api.md) · [All operations](https://skmtc.net/smokeball/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smokeball/api/versions/197984da9b42/schema)