# Uploading Media

To launch one or more analyses for your media files, you need to create a folder via Oz API (or use an existing folder) and put the files into this folder. Each file should be marked by [tags](https://doc.ozforensics.com/oz-knowledge/guides/developer-guide/api/oz-api/media-tags): they describe what's pictured in a media and determine the applicable analyses.

{% hint style="info" %}
**For API 4.0.8 and below**, please note: if you want to upload a photo for the subsequent Liveness analysis, put it into the ZIP archive and apply the [video-related](https://doc.ozforensics.com/oz-knowledge/guides/developer-guide/api/media-tags#tags-for-video-files) tags.
{% endhint %}

To create a folder and upload media to  it, call `POST /api/folders/`

To add files to the existing folder, call `POST /api/folders/{{folder_id}}/media/`

Add the files to the request body; tags should be specified in the payload.

Here's the example of the payload for a passive Liveness video and ID front side photo.

<pre class="language-json" data-title="payload"><code class="lang-json">{
    "media:tags": { // this section sets the tags for the media files that you upload
    // media files are referenced by the keys in a multipart form
        "video1": [ // your file key
        // a typical set of tags for a passive Liveness video
            "video_selfie", // video of a person
            "video_selfie_blank", // no <a data-footnote-ref href="#user-content-fn-1">gesture</a> used
            "orientation_portrait" // video orientation
        ],
        "photo1": [
        // a typical set of tags for an ID front side
            "photo_id",
            "photo_id_front"
        ]
    }
}
</code></pre>

An example of usage (Postman):

<figure><img src="https://2532558063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5g6dgsxRbyrCvB0uAf8f%2Fuploads%2F7dDC0RpM5tAIfCWOL210%2FScreenshot_49.png?alt=media&#x26;token=7ce8df2a-14a8-4a62-bdb5-f2793bbf244b" alt=""><figcaption></figcaption></figure>

The successful response will return the folder data.

[^1]: Liveness gestures are described [here](https://doc.ozforensics.com/oz-knowledge/general/readme/passive-and-active-liveness)