# Start instrument action

**POST /control/instruments/{serial}/action**

Perform various actions on the instrument, including starting calibration or SIC.

This will return the current status of the operation. *Calibration* and *SIC* can take a long time, so if it returns *InProgress* you will need to check the calibration or sic status endpoints or wait for the relevant webhook to fire.
        
Requires an API key with the `instruments:action` scope.


## Servers
- Production server: https://api.mycirrus.cloud/v1 (Production server)



## Parameters

### Path parameters
- **serial** (string)
  Serial number of the selected instrument

### Query parameters
- **action** (string)



## Responses
### 200
OK

#### Body: application/json (object)
- **action** (string)

- **status** (string)


### 400
There is an error in the request, possibly missing parameter or incorrect url.

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 401
Your access token is invalid or has expired

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 403
You do not have permission to access this data

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 404
There is an error in the request, possibly missing parameter or incorrect url.

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 429
You have made too many requests in a short time

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error


[Powered by Bump.sh](https://bump.sh)