---
title: "Reserve a Project Asset"
method: POST
path: "/video-projects/{id}/assets"
tags: ["Video Projects"]
---

# Reserve a Project Asset

`POST /video-projects/{id}/assets`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/video-projects/{id}/assets`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

Project Assets are private editing dependencies and do not appear in the Workspace Media Library.

## Path parameters

- `id` string, required: Video project ID

## Request body

- ReserveProjectAssetInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `device_id` string
  - `mime_type` string, required
  - `original_filename` string, required
  - `preparation` object, required: Non-destructive trim, crop, rotation, gain, mute, and cover-frame recipe
  - `sha256` string
  - `size` integer, required
  - `stable_media_id` string, required
  - `workspace_id` string, required

## Response `200`

OK

- ProjectAssetResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `attention_reason` string
  - `created_at` string, required
  - `device_id` string
  - `id` string, required
  - `media_id` string
  - `mime_type` string, required
  - `original_filename` string, required
  - `preparation` object, required
  - `project_id` string, required
  - `required` boolean, required
  - `sha256` string
  - `size` integer, required
  - `stable_media_id` string, required
  - `status` 'pending' | 'uploading' | 'ready' | 'needs_storage' | 'failed', required
  - `updated_at` string, required
  - `uploaded_by_user_id` string, required
  - `workspace_id` string, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)