---
title: "Start an upload"
method: POST
path: "/api/v1/upload/init"
tags: ["upload"]
---

# Start an upload

`POST /api/v1/upload/init`

## Request body

- object
  - `nodeId` string, uuid
  - `filename` string, required
  - `contentType` string, required
  - `sizeInBytes` integer, required
  - `purpose` 'asset' | 'avatar' | 'team-photo' | 'custom-font'

## Response `200`

200

- object
  - `uploadId` string, required
  - `s3Bucket` string, required
  - `s3Key` string, required
  - `partSize` number, required

## Other responses

- `401` — Missing, invalid, expired, or revoked API key.
- `403` — The API key's user is not a member of the requested team.
- `429` — Rate limit reached — retry after the `Retry-After` header.

---

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