# Set instrument information

**PUT /control/instruments/{serial}**

Change values for the specified instrument. Currently only the Name of the instrument can be modified.
      
Requires an API key with the `instruments:write` scope.


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



## Parameters

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


### Body: application/json (object)
Can pass the whole Instrument object or just an object containing Name
- **type** (string)
  Type of instrument
- **serialNumber** (string)
  Serial number of the instrument
- **model** (string)
  Model of the instrument
- **name** (string)
  Friendly name or description of the instrument
- **image** (string(uri))
  URL of the image for the instrument
- **subscription** (object)
  Subscription details for this instrument
- **position** (object)
  Position of the instrument
- **feature** (array[string])
  Additional features available on this instrument


## Responses
### 204
No Content

### 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


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