# Create Evidence

## Create a new evidence item

<mark style="color:blue;">`POST`</mark> `/api/v1/evidence`

Use this API endpoint to create evidence items within Monolith.

Either case\_id, case\_uuid, or case\_number is required.

If evidence\_number is not provided, Monolith will automatically generate a value.

**Request Body**

| Name              | Type   | Description                                                                                           |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| `case_id`         | number | Unique ID of a case to link evidence.                                                                 |
| `case_uuid`       | string | Unique ID of a case to link evidence.                                                                 |
| `case_number`     | string | Case number to link evidence.                                                                         |
| `evidence_number` | string | Evidence number of the evidence being created.                                                        |
| `item_name`       | string | Name of the evidence item.                                                                            |
| `type`            | string | The type of evidence item: (Smartphone, Server, Email, etc...)                                        |
| `location_id`     | number | Sets the location of the evidence item at creation.  Location ID can be retreived from locations API. |
| `provider`        | string | Service provider or manufacturer of evidence.                                                         |
| `model_number`    | string | Evidence model number.                                                                                |
| `unique_id`       | string | Unique ID associated with the device - usually a serial number or account name.                       |
| `size`            | number | Capacity of the evidence                                                                              |
| `size_unit`       | string | <p>Unit of capacity:<br>KB, MB, GB, TB, PB</p>                                                        |
| `description`     | string | Description of the item                                                                               |
| `custom_fields`   | array  | Array of custom field objects                                                                         |

## Custom Fields

To create custom fields for your evidence in an API request, you must include a `custom_fields` value that consists of an array of JSON objects in the following form:

| Name       | Type    | Description                                      |
| ---------- | ------- | ------------------------------------------------ |
| `field_id` | integer | Unique id of the custom field                    |
| `value`    | string  | This is the value to be set for the custom field |

The `field_id` is the numeric identifier for the custom field you are setting a value for.

```json
// Custom Fields Example
"custom_fields": [
    {
        "field_id": "1",
        "value": "I am some custom data."
    },
    {
        "field_id": "2",
        "value": "This is some separate custom field data."
    }
]
```