---
search:
  tags:
    - Media
    - POST
seo:
  description: >-
    Returns a presigned PUT URL, valid for 10 minutes. PUT the bytes, then call…
    Reference for the POST /api/cli/media/uploads endpoint in the BrainyShorts
    API.
sidebar:
  label: Reserve a managed media upload
  badge: POST
title: Reserve a managed media upload
type: openapi-operation
---
Returns a presigned PUT URL, valid for 10 minutes. PUT the bytes, then call PATCH to complete. If `already_uploaded` is true, skip the PUT and reuse `asset_id`. Requires the `media:write` scope.

`POST /api/cli/media/uploads`