# \_setStatus

Sets the Status of an Opportunity.

### Parameters

#### id

The ID of the Opportunity being modified.

#### val

The status which the Opportunity will be set to:\
Draft => 1\
Quoted => 2\
Lost => 3

### Example

```
FM_api('Opportunity_setStatus',[
  'id'=>'60004',
  'val'=>'1'
]);
```

### Results

#### On Success

```
{"ok":1}
```

If the "val" parameter already fits the current status of the Opportunity.

```
{"ok":1,"warning":"no change required"}
```

#### On Failure

If the "id" parameter is not set:

```
{"error":"missing or invalid parameter: id"}
```

If the "val" parameter is not set:

```
{"error":"missing or invalid parameter: val"}
```

If the "id" parameter does not match the ID of an existing Opportunity:

```
{"error":"opportunities is not existing"}
```