---
title: "Start a new vault media upload."
method: POST
path: "/api/v0/accounts/{account_id}/vault/medias/uploads/start"
tags: ["vault"]
---

# Start a new vault media upload.

`POST /api/v0/accounts/{account_id}/vault/medias/uploads/start`

## Request

- Base URL: `https://omapi.onlymonster.ai`
- URL: `https://omapi.onlymonster.ai/api/v0/accounts/{account_id}/vault/medias/uploads/start`
- Auth: API key in header `x-om-auth-token`

**Rate limit:** 3 requests per second

**Required permission:** `media_uploader.manage`

## Path parameters

- `account_id` string, required

## Request body

- object
  - `name` string, required
  - `size` integer, required
  - `content_type` string, required
  - `duration` number

## Response `200`

Default Response

- union
  - object
    - `get_url` string, required
    - `put_url` string, required
    - `key` string, required
  - object
    - `get_url` string, required
    - `upload_id` string, required
    - `parts` object[], required
      - `id` integer, required
      - `put_url` string, required
    - `key` string, required

## Other responses

- `403`: The API key lacks the permission this endpoint requires, or the request is outside what the organisation or the API key can access.

## Changes

- **2026-11-03** `20f58411c6c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onlymonster/apis/om-api-service/changes/api/v0/accounts/:account_id/vault/medias/uploads/start/post.md)

---

[API](https://skmtc.dev/onlymonster/apis/om-api-service.md) - [All operations](https://skmtc.dev/onlymonster/apis/om-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/onlymonster/apis/om-api-service/revisions/0003edb0288a?raw)