---
title: "Complete media upload session"
method: POST
path: "/media/upload-sessions/{uploadSessionId}/complete"
tags: ["Media"]
---

# Complete media upload session

`POST /media/upload-sessions/{uploadSessionId}/complete`

## Request

- Base URL: `https://api.woopsocial.com/v1`
- URL: `https://api.woopsocial.com/v1/media/upload-sessions/{uploadSessionId}/complete`
- Auth: HTTP bearer

Call this to finalize the upload started by calling [`/media/upload-sessions`](/api-reference/media/start-media-upload-session).

## Path parameters

- `uploadSessionId` string, required

## Response `200`

Upload completion accepted.

- union
  - UploadSessionInitiatedStatus
    - `status` 'INITIATED', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionUploadedStatus
    - `status` 'UPLOADED', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionReadyStatus
    - `mediaId` string, required: Media identifier created by the completed upload.
    - `status` 'READY', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionFailedStatus
    - `failureCode` string, required: Machine-readable failure code for the upload session.
    - `failureMessage` string, required: Human-readable summary of why the upload session failed.
    - `status` 'FAILED', required
    - `uploadSessionId` string, required: Media upload session identifier.
  - UploadSessionAbortedStatus
    - `status` 'ABORTED', required
    - `uploadSessionId` string, required: Media upload session identifier.

## Other responses

- `429`: Too many requests are already in progress for this API key.

---

[API](https://skmtc.dev/woopsocial/apis/woopsocial-api.md) · [All operations](https://skmtc.dev/woopsocial/apis/woopsocial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/woopsocial/apis/woopsocial-api/revisions/578a984c20d9?raw)