# $add

`$add` operator lets you **add** multiple values and return the result of the expression. You can use this in any [<mark style="color:blue;">**Expression Object**</mark>](https://docs.cosmocloud.io/flow-builder/cql-cosmocloud-query-language/building-expressions).

## Syntax

```json
{
    "$add": [ <expr>, <expr>, ... ]
}
```

### Properties

| Field   | Description                                                                                                                                                                                                                     | Required |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| \<expr> | <p>The <code>\<expr></code> expression can be any valid <a href=""><mark style="color:blue;"><strong>expression</strong></mark></a> as long as it resolves to a number.</p><p></p><p>It can also be a Magical Autocomplete.</p> | true     |

### Returns

`float` - The result of $add operation

## Examples

### Basic example

```json
{
    "$add": [1, 2, 3]
}
```

The above expression returns **6.0**

### With Nested Expressions

```json
{
    "$add": [ { "$add": [1, 2] }, 3, 4 ]
}
```

The above expression calculates the nested expression, return **3** in its place and then the outer `$add` expression returns **10** overall.

### With Magical Autocomplete

Let's say we have declared a variable `temp` in our API flow, which has a value of **5** currently.

```json
{
    "$add": ["$.variables.temp", 3]
}
```

The above expression would resolve to a result of **8.0**