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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.ozforensics.com/oz-knowledge/guides/developer-guide/api/oz-api/use-cases/uploading-media.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.