Confirm Uploaded Media

PATCH

/media/{mediaId}

Once you finish uploading the file using the PUT {uploadUrl}, you must use the mediaId generated from the POST /media request to perform this request to confirm the media has been sucessfully uploaded.

If you do not confirm the upload your media will stay in PROCESSING status and eventually be deleted.
Without this confirmation the media is unusable and posts WILL NOT get published

After confirmation, use GET /media/:mediaId to check the status and understand if it is already usable, in SUCCESS status, it shouldn't take more than a few minutes.

Request

Path Params

Header Params

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.swonkie.dev/v2/media/TWVkaWFJZDk4NzY1NDMyMQ' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'

Response Example

{
    "id": "string",
    "name": "string",
    "path": "http://example.com",
    "preview": "http://example.com",
    "type": "string",
    "status": "PROCESSING",
    "specs": {
        "width": 0,
        "height": 0,
        "duration": 0,
        "fileSizeBytes": 0
    },
    "createdAt": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-03-11 19:21:12

Upload File to Media

Delete a Media