# Create Media

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


`POST /media`

Creates a new media item. See [Media Object](/docs/media) for more details.

### Parameters

```json
[
  {
    "$ref": "#/components/parameters/AcceptVersionHeader"
  }
]
```

### Request Body

The request body should contain a properly formatted JSON object with one or more of `title`, `alt`, or `metadata` properties. 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": "My Video Example",
  "alt": "An example video used to demonstrate the ittybit API",
  "metadata": {
    "customKey": "your custom value"
  }
}
```

### Responses

#### 201 - Success

**Example:**

```json
{
  "id": "med_abcdefgh1234",
  "object": "media",
  "kind": null,
  "title": "My Video Example",
  "alt": "An example video used to demonstrate the ittybit API",
  "files": [],
  "urls": {},
  "background": null,
  "metadata": {
    "customKey": "your custom value"
  },
  "created": "2025-01-01T01:23:45Z",
  "updated": "2025-01-01T01:23:45Z"
}
```