> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Metadata

Create a new metadata item for a revision.

## **POST** `/revisions/:id/metadata/:alias`

### Path Parameters

| Parameter | Type   | Required | Description                          |
| :-------- | :----- | :------- | :----------------------------------- |
| `id`      | string | Yes      | The unique ID of the revision.       |
| `alias`   | string | Yes      | The alias for the new metadata item. |

### Request Body

| Parameter | Type   | Required | Description             |
| :-------- | :----- | :------- | :---------------------- |
| `value`   | string | No       | Arbitrary string value. |
| `data`    | object | No       | Arbitrary JSON object.  |

### Response

| Parameter | Type   | Description                        |
| :-------- | :----- | :--------------------------------- |
| `item_id` | string | The unique ID of the created item. |

### Example

<CodeGroup>
  ```json Request theme={null}
  {
    "value": "approved",
    "data": { "approver": "admin" }
  }
  ```

  ```json Response theme={null}
  {
    "item_id": "meta_004"
  }
  ```
</CodeGroup>