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

# Insight Mutate

## Mutate an insight to LogSnag.

<mark style="color:purple;">`PATCH`</mark> `https://api.logsnag.com/v1/insight`

This endpoint allows you to change (mutate) existing numerical insights.

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Content-Type  | String | application/json |
| Authorization | String | Bearer \<TOKEN>  |

#### Request Body

| Name                                      | Type     | Description                      |
| ----------------------------------------- | -------- | -------------------------------- |
| project<mark style="color:red;">\*</mark> | String   | Project name                     |
| title<mark style="color:red;">\*</mark>   | String   | Insight title                    |
| value<mark style="color:red;">\*</mark>   | Mutation | See example below                |
| icon                                      | Emoji    | Single emoji as the insight icon |

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

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

### Mutation Object

#### Increment ($inc)

The increment mutation changes a numerical value by increasing or decreasing it. It can be applied to an existing insight or 0 if no insight exists. The mutation can be performed using either positive or negative numbers.

```json
{
    "project": "makershq",
    "title": "Online Users",
    "value": {
        "$inc": 1
    },
    "icon": "🔴"
}
```

&#x20;