# Mutation

## Get List Mutation

The table given below describes the `/api/v2/mutation`.

## Get Mutation

<mark style="color:blue;">`GET`</mark> `https://app.moota.co/api/v2/mutation`

#### Query Parameters

| Name        | Type   | Description                                                                   |
| ----------- | ------ | ----------------------------------------------------------------------------- |
| type        | string | Type of type mutation example value `CR` \<credit> and `DB` \<debit>          |
| bank        | string | Bank of bank id you account can selected                                      |
| amount      | string | Amount of selected by amount can show it                                      |
| note        | string | Note of selected can show you want                                            |
| start\_date | string | Start Date of selected by date ranges start end mutation date                 |
| end\_date   | string | End Date of selected by date ranges start end mutation date                   |
| tag         | string | Tag of selected by your tag example tag\_name, tag\_name with separator comma |
| page        | string | Page can show data start from page number to ...                              |
| per\_page   | string | Per Page can show total rows                                                  |

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

```
{
  "current_page": 1,
  "data": [
    {
      "account_number": "235264741",
      "date": "2021-10-05 00:00:00",
      "description": "buy other food",
      "amount": "100123.00",
      "type": "CR",
      "note": "",
      "balance": "0.00",
      "created_at": "2021-10-05 10:25:16",
      "updated_at": "2021-10-05 10:25:16",
      "mutation_id": "aolk4PekJxM",
      "token": "aolk4PekJxM",
      "bank_id": "VLagzqBj42D",
      "taggings": [],
      "bank": {
        "corporate_id": null,
        "username": "moota.co",
        "atas_nama": "Moota",
        "balance": "100123.00",
        "account_number": "235264741",
        "bank_type": "bca",
        "login_retry": 0,
        "date_from": "2021-09-24 00:00:00",
        "date_to": "2021-09-24 00:00:00",
        "meta": null,
        "interval_refresh": 15,
        "next_queue": "2021-09-24 11:16:57",
        "is_active": true,
        "in_queue": 0,
        "in_progress": 0,
        "recurred_at": "2021-09-25 11:01:57",
        "created_at": "2021-09-24 11:01:57",
        "token": "VLagzqBj42D",
        "bank_id": "VLagzqBj42D",
        "label": "BCA",
        "last_update": "2021-09-24T03:46:57.000000Z"
      }
    },
    {
      "account_number": "7650583974",
      "date": "2021-09-24 00:00:00",
      "description": "quaerat",
      "amount": "133041.00",
      "type": "DB",
      "note": "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley ",
      "balance": "0.00",
      "created_at": "2021-09-24 11:01:57",
      "updated_at": "2021-09-24 11:01:57",
      "mutation_id": "8aolk43WJxM",
      "token": "8aolk43WJxM",
      "bank_id": "e42qjy2WGE5",
      "taggings": [
        {
          "name": "car",
          "tag_id": "M1Z6zK0jJDY"
        }
      ],
      "bank": {
        "corporate_id": null,
        "username": "moota.co",
        "atas_nama": "Moota",
        "balance": "126987.00",
        "account_number": "0144050",
        "bank_type": "mandiriBisnis",
        "login_retry": 0,
        "date_from": "2021-09-24 00:00:00",
        "date_to": "2021-09-24 00:00:00",
        "meta": null,
        "interval_refresh": 15,
        "next_queue": "2021-09-24 11:16:57",
        "is_active": true,
        "in_queue": 0,
        "in_progress": 0,
        "recurred_at": "2021-09-25 11:01:57",
        "created_at": "2021-09-24 11:01:57",
        "token": "e42qjy2WGE5",
        "bank_id": "e42qjy2WGE5",
        "label": "Mandiri Bisnis",
        "last_update": "2021-09-24T03:46:57.000000Z"
      }
    }
  ],
  "first_page_url": "https://app.moota.co/api/v2/mutation?page=1",
  "from": 1,
  "last_page": 50,
  "last_page_url": "https://app.moota.co/api/v2/mutation?page=50",
  "links": [
    {
      "url": null,
      "label": "Sebelumnya",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=2",
      "label": "2",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=3",
      "label": "3",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=4",
      "label": "4",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=5",
      "label": "5",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=6",
      "label": "6",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=7",
      "label": "7",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=8",
      "label": "8",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=9",
      "label": "9",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=10",
      "label": "10",
      "active": false
    },
    {
      "url": null,
      "label": "...",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=49",
      "label": "49",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=50",
      "label": "50",
      "active": false
    },
    {
      "url": "https://app.moota.co/api/v2/mutation?page=2",
      "label": "Selanjutnya",
      "active": false
    }
  ],
  "next_page_url": "https://app.moota.co/api/v2/mutation?page=2",
  "path": "https://app.moota.co/api/v2/mutation",
  "per_page": "2",
  "prev_page_url": null,
  "to": 2,
  "total": 100
}
```

{% endtab %}
{% endtabs %}

## Create Dummy Mutation

you can create test with dummy mutation for you bank account

The table given below describes the `/api/v2/mutation/store/{bank_id}`.

Use this API to update an existing beneficiary identified by its `bank_id`.

## Store Mutation

<mark style="color:green;">`POST`</mark> `https://app.moota/co/api/v2/mutation/store/{bank_id}`

#### Path Parameters

| Name     | Type   | Description                                          |
| -------- | ------ | ---------------------------------------------------- |
| bank\_id | string | Bank Id identified target mutation from bank account |

#### Request Body

| Name   | Type   | Description                                                       |
| ------ | ------ | ----------------------------------------------------------------- |
| date   | string | Date of value for mutation                                        |
| note   | string | Note of value for mutation                                        |
| amount | string | Amount of value total amount dumy                                 |
| type   | string | Type of value for mutation like `CR` \<credit>  and `DB` \<debit> |

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

```
{
  "error": false,
  "mutation": {
    "total": 1,
    "new": 1
  }
}
```

{% endtab %}

{% tab title="422 " %}

```
{
  "message": "The given data was invalid.",
  "errors": {
    "date": [
      "The date does not match the format Y-m-d."
    ],
    "type": [
      "The selected type is invalid."
    ]
  }
}
```

{% endtab %}
{% endtabs %}

## Add Note To Mutation

The table given below describes the `/api/v2/mutation/{mutation_id}/note`.

Use this API to update an existing beneficiary identified by its `mutation_id`.

## Add Note Mutation

<mark style="color:green;">`POST`</mark> `https://app.moota.co/api/v2/mutation/{mutation_id}/note`

#### Path Parameters

| Name         | Type   | Description                                            |
| ------------ | ------ | ------------------------------------------------------ |
| mutation\_id | string | Mutation Id of identified mutation target can add note |

#### Request Body

| Name | Type   | Description                 |
| ---- | ------ | --------------------------- |
| note | string | Note of value mutation note |

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

```
{
  "message": "OK",
}
```

{% endtab %}

{% tab title="404 " %}

```
{
  "message": "Data not found"
}
```

{% endtab %}
{% endtabs %}

## Push Mutation With Webhook

Moota can re try push webhook by request with this endpoint `/api/v2/mutation/{mutation_id}/webhook`.

Use this API to update an existing beneficiary identified by its `mutation_id`.

## Push Mutation&#x20;

<mark style="color:green;">`POST`</mark> `https://app.moota.co/api/v2/mutation/{mutation_id}/webhook`

#### Path Parameters

| Name         | Type   | Description                                              |
| ------------ | ------ | -------------------------------------------------------- |
| mutation\_id | string | Mutation Id of identified mutation can push with webhook |

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

```
{
  "message": "OK",
}
```

{% endtab %}

{% tab title="404 " %}

```
{
  "message": "Data not found"
}
```

{% endtab %}
{% endtabs %}

## Remove Mutation

The table given below describes the `/api/v2/mutation/destroy`.

## Remove

<mark style="color:green;">`POST`</mark> `https://api.moota.co/api/v2/mutation/destroy`

#### Request Body

| Name      | Type  | Description                    |
| --------- | ----- | ------------------------------ |
| mutations | array | Mutations of array mutation id |

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

```
{
  "message": "OK"
}
```

{% endtab %}

{% tab title="422 " %}

```
{
  "message": "The given data was invalid.",
  "errors": {
    "mutations": [
      "The mutations must be an array."
    ]
  }
}
```

{% endtab %}
{% endtabs %}

## Attach Tagging To Mutation

The table given below describes the `/api/v2/tagging/mutation/{mutation_id}`.

## Attach Tagging

<mark style="color:green;">`POST`</mark> `https://app.moota.co/api/v2/tagging/mutation/{mutation_id}`

#### Path Parameters

| Name         | Type   | Description                               |
| ------------ | ------ | ----------------------------------------- |
| mutation\_id | string | Mutation Id of identified target mutation |

#### Request Body

| Name | Type  | Description                |
| ---- | ----- | -------------------------- |
| name | array | Name of array tagging name |

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

```
{
  "message": "Tag berhasil ditambahkan ke mutasi"
}
```

{% endtab %}

{% tab title="422 " %}

```
{
  "message": "User tidak memiliki tag ini"
}
```

{% endtab %}
{% endtabs %}

## Update Tagging From Mutation

The table given below describes the `/api/v2/tagging/mutation/mutation_id}.`

## Update Tagging Mutation

<mark style="color:orange;">`PUT`</mark> `https://app.moota.co/api/v2/tagging/mutation/{mutation_id}`

#### Path Parameters

| Name         | Type   | Description                                                              |
| ------------ | ------ | ------------------------------------------------------------------------ |
| mutation\_id | string | Mutation Id of identified mutation can update tagging name from mutation |

#### Request Body

| Name | Type  | Description                                                  |
| ---- | ----- | ------------------------------------------------------------ |
| name | array | Name of array tagging value for update tagging from mutation |

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

```
{
  "message": "Tag berhasil diupdate ke mutasi"
}
```

{% endtab %}

{% tab title="422 " %}

```
{
  "message": "User tidak memiliki tag ini"
}
```

{% endtab %}
{% endtabs %}

## Detach Tagging From Mutation

The table given below describes the `/api/v2/tagging/mutation/{mutation_id}.`

## Detach Tagging Mutation

<mark style="color:red;">`DELETE`</mark> `https://app.moota.co/api/tagging/mutation/{mutation_id}`

#### Path Parameters

| Name         | Type   | Description                                                       |
| ------------ | ------ | ----------------------------------------------------------------- |
| mutation\_id | string | Mutation Id of identified target mutation can remove tagging name |

#### Request Body

| Name | Type  | Description                                    |
| ---- | ----- | ---------------------------------------------- |
| name | array | Name of array tagging can remove from mutation |

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

```
{
  "message": "Tag berhasil dihapus dari mutasi"
}
```

{% endtab %}

{% tab title="422 " %}

```
{
  "message": "User tidak memiliki tag ini"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://moota.gitbook.io/technical-docs/mutation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.