---
title: "Get a temporary URL to upload a file to a certain file path via a PUT request with the file data."
method: POST
path: "/api/v1/Files/GetUploadUrl"
tags: ["Files"]
---

# Get a temporary URL to upload a file to a certain file path via a PUT request with the file data.

`POST /api/v1/Files/GetUploadUrl`

## Request

- Base URL: `https://api.slopesoftware.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.slopesoftware.com/api/v1/Files/GetUploadUrl`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/slopesoftware/apis/akur8-life-api/docs/api/v1/Files/GetUploadUrl/post.ts> (a function with typed inputs; its response is checked against the schema)

Passing in the ContentType and ContentMD5 values is optional. If provided, they will be included in the signature, but are not stored at this point. <br/><br/>Exclude the <i>'Content-Type'</i> header from the PUT request if this is not set. <br/>If included, the <i>'Content-Type'</i> header in the PUT request must match the provided ContentType value. <br/><br/>Exclude the <i>'ContentMD5'</i> header from the PUT request if this is not set. <br/>If included, the <i>'Content-MD5'</i> header in the PUT request must match the provided ContentMD5 value. <br/><br/><b>NOTE:</b> There is a 5GB limit on the size of the file.

## Request body

- GetUploadUrlFilePathDtoV1
  - `filePath` string, nullable: File Path
  - `contentType` string, nullable: Optional File Content Type
  - `contentMD5` string, nullable: Optional MD5 Hash for File Content

## Response `200`

OK

- GetUploadUrlResponseV1
  - `uploadUrl` string, nullable: URL to use to upload file content

## Other responses

- `201`: Created
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Not Allowed To Access
- `404`: Not Found
- `429`: Too Many Requests

---

[API](https://skmtc.dev/slopesoftware/apis/akur8-life-api.md) - [All operations](https://skmtc.dev/slopesoftware/apis/akur8-life-api/llms.txt) - [OpenAPI document](https://skmtc.dev/slopesoftware/apis/akur8-life-api/revisions/9771b2c79880?raw)