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

# \_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"}
```