---
title: "Complete a streaming media upload session"
method: POST
path: "/media/upload-session/{id}/complete"
tags: ["Media"]
---

# Complete a streaming media upload session

`POST /media/upload-session/{id}/complete`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/media/upload-session/{id}/complete`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Path parameters

- `id` string, required: Pending media ID

## Request body

- CompleteMediaUploadSessionInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `workspace_id` string, required: Workspace ID

## Response `200`

OK

- MediaUploadResult
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `alt_text` string, required: Persisted alt text
  - `analysis_error` string: Media analysis error
  - `analysis_status` string, required: Media analysis status
  - `asset_kind` string, required: Media library role
  - `deduped` boolean, required: Whether an existing media attachment was reused
  - `design_document_id` string: Producing OpenPost Image Editor design ID
  - `design_page_id` string: Producing OpenPost Image Editor page ID
  - `id` string, required: Media ID
  - `mime_type` string, required: MIME type
  - `original_filename` string, required: Persisted original filename
  - `parent_media_id` string: Source media ID
  - `poster_thumbnail_url` string: Poster thumbnail URL
  - `processing_progress` integer, required: Server processing progress from 0 to 100
  - `processing_status` string, required: Media processing status
  - `retention_class` 'library' | 'temporary', required: Media lifecycle class
  - `size` integer, required: File size in bytes
  - `source` string, required: Media provenance
  - `url` string, required: URL to access the media

## 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)