---
title: "Get link for uploading (S3 storage only)"
method: POST
path: "/images/buildS3UploadLink/{assetId}"
tags: ["Assets"]
---

# Get link for uploading (S3 storage only)

`POST /images/buildS3UploadLink/{assetId}`

## Request

- Base URL: `https://api.pics.io`
- URL: `https://api.pics.io/images/buildS3UploadLink/{assetId}`
- Auth: HTTP bearer

Build upload links for multipart upload. [Upload instruction](https://api.pics.io/docs/how-to-upload-assets)

## Request body

- object
  - `fileName` string, required
  - `fileSize` number, required
  - `mimeType` string, required
  - `collectionId` string, required

## Response `200`

Ok

- object
  - `uploadId` string
  - `storageId` string
  - `revisionId` string
  - `chunkNums` number
  - `urls` object[]
    - `partNum` number
    - `url` string

---

[API](https://skmtc.dev/pics/apis/pics-io-rest-api.md) - [All operations](https://skmtc.dev/pics/apis/pics-io-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pics/apis/pics-io-rest-api/revisions/ea41cba5ac37?raw)