---
title: "Initialize a file upload. Responds with an URL where the file can be uploaded."
method: POST
path: "/api/v1/user/file/{name}/initUpload"
tags: ["user"]
---

# Initialize a file upload. Responds with an URL where the file can be uploaded.

`POST /api/v1/user/file/{name}/initUpload`

## Path parameters

- `name` string, required

## Query parameters

- `folder` string, required

## Request body

- FileUploadDTO — Details on content, ownership, purpose and access rights of a file to be uploaded.
  - `identifiers` ConfigIdentifierDTO[]
    - `identifierType` string, required
    - `identifierValue` string, required
  - `flags` string[]
  - `access` ConfigAccessDTO[]
    - `accessorId` 'full' | 'readOnly', required — ID of the accessing entity
    - `rights` 'full' | 'readOnly', required — access rights to a resource

## Response `200`

Provided URL to upload file.

- InitPutRecordingAudioDTO — Object that specifies where to upload a file so it can be processed.
  - `isrc` string
  - `objectKey` string
  - `url` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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