# Update Media

[View original](https://ittybit.cloud/api/media/update)


`PATCH /media/{id}`

Updates a media object's `title`, `alt`, or `metadata`. Only the specified fields will be updated.

### Parameters

```json
[
  {
    "$ref": "#/components/parameters/AcceptVersionHeader"
  },
  {
    "in": "path",
    "name": "id",
    "required": true,
    "schema": {
      "type": "string",
      "example": "med_abcdefgh1234"
    }
  }
]
```

### Request Body

The request body should contain a properly formatted JSON object. Optional properties are listed below. See [Media Object](/docs/media) for more details.

**Schema:**

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "alt": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    }
  }
}
```

**Example:**

```json
{
  "title": "Updated Video Example",
  "alt": "An updated example video used to demonstrate the ittybit API",
  "metadata": {
    "customKey": "a different custom value"
  }
}
```

### Responses

#### 200 - Success

**Example:**

```json
{
  "id": "med_abcdefgh1234",
  "object": "media",
  "kind": "video",
  "title": "Updated Video Example",
  "alt": "An updated example video used to demonstrate the ittybit API",
  "width": 1920,
  "height": 1080,
  "duration": 123.45,
  "files": [
    {
      "id": "file_abcdefgh1234",
      "object": "source",
      "etc": "..."
    },
    {
      "id": "file_abcdefgh5678",
      "object": "source",
      "etc": "..."
    }
  ],
  "urls": {
    "original": "https://you.ittybit.net/example/video.mp4",
    "thumbnail": "https://you.ittybit.net/example/image.png"
  },
  "background": "#2OBO75",
  "metadata": {
    "customKey": "a different custom value"
  },
  "created": "2025-01-01T01:23:45Z",
  "updated": "2025-01-01T01:23:46Z"
}
```