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

# Media

{% openapi src="/files/DFxnj85ZsASPYXzkPAko" path="/api/v3/media/1" method="get" %}
[UshahidiV3.json](https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json)
{% endopenapi %}

## edit media

<mark style="color:orange;">`PUT`</mark> `https://ushahididocs.api.ushahidi.io/api/v3/media/1`

#### Request Body

| Name                 | Type   | Description                               |
| -------------------- | ------ | ----------------------------------------- |
| user\_id             | String | The user identifier                       |
| o\_size              | String | File Size                                 |
| o\_filename          | String | File name                                 |
| mime                 | String | Media import location e.g. `"image/jpeg"` |
| caption              | String | The media caption                         |
| original\_width      | String | Width dimension                           |
| original\_file\_size | String | The media file size                       |
| original\_file\_url  | String | The media file URL                        |
| original\_height     | String | Height dimension                          |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "id": 1,
    "url": "http://localhost:8000/api/v3/media/1",
    "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
    },
    "caption": "ihub",
    "created": "2013-10-15T05:43:41+00:00",
    "updated": "2013-10-15T05:43:39+00:00",
    "mime": "image/jpeg",
    "original_file_url": "http://localhost:8000/storage/9ze_1381815819_o.jpg",
    "original_file_size": 1024,
    "original_width": 400,
    "original_height": 500,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}
```

{% endtab %}
{% endtabs %}

{% openapi src="/files/DFxnj85ZsASPYXzkPAko" path="/api/v3/media/3" method="delete" %}
[UshahidiV3.json](https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json)
{% endopenapi %}