> For the complete documentation index, see [llms.txt](https://docs.taqnyat.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taqnyat.sa/api-reference/media-1.md).

# Media

Upload and retrieve WhatsApp media files.

## Upload Media

> Upload a media file for use in WhatsApp messages.

```json
{"openapi":"3.0.3","info":{"title":"Taqnyat WhatsApp API","version":"2.0"},"tags":[{"name":"Media","description":"Upload and retrieve WhatsApp media files."}],"servers":[{"url":"https://api.taqnyat.sa/wa/v2","description":"Taqnyat WhatsApp API"}],"security":[{"ApiToken":[]}],"components":{"securitySchemes":{"ApiToken":{"type":"apiKey","in":"header","name":"Authorization","description":"Taqnyat API token."}}},"paths":{"/media/":{"post":{"tags":["Media"],"summary":"Upload Media","description":"Upload a media file for use in WhatsApp messages.","operationId":"uploadMedia","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file","type","messaging_product"],"properties":{"file":{"type":"string","format":"binary","description":"Media file to upload."},"type":{"type":"string","description":"MIME type of the uploaded file."},"messaging_product":{"type":"string","enum":["whatsapp"]}}}}}},"responses":{"200":{"description":"Media uploaded successfully."},"401":{"description":"Invalid or missing API token."}}}}}}
```

## Get Media

> Retrieve previously uploaded media using its unique media ID.

```json
{"openapi":"3.0.3","info":{"title":"Taqnyat WhatsApp API","version":"2.0"},"tags":[{"name":"Media","description":"Upload and retrieve WhatsApp media files."}],"servers":[{"url":"https://api.taqnyat.sa/wa/v2","description":"Taqnyat WhatsApp API"}],"security":[{"ApiToken":[]}],"components":{"securitySchemes":{"ApiToken":{"type":"apiKey","in":"header","name":"Authorization","description":"Taqnyat API token."}}},"paths":{"/media/{media_id}":{"get":{"tags":["Media"],"summary":"Get Media","description":"Retrieve previously uploaded media using its unique media ID.","operationId":"getMedia","parameters":[{"name":"media_id","in":"path","required":true,"description":"Unique identifier of the uploaded media.","schema":{"type":"string"}}],"responses":{"200":{"description":"Media resource retrieved successfully."},"401":{"description":"Invalid or missing API token."},"404":{"description":"Media not found."}}}}}}
```