> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atomscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Synthesis Instrument

> Update an existing synthesis instrument

Updates an existing synthesis instrument. Include only the fields you want to change.

<ParamField path="synthesis_instrument_id" type="integer" required>
  ID of the synthesis instrument to update
</ParamField>

<ParamField body="name" type="string">
  Name of the instrument
</ParamField>

<ParamField body="label" type="string">
  Label for the instrument
</ParamField>

<ParamField body="type" type="string">
  Synthesis source type. One of `mbe`, `pvd`, `sputter`, `cvd`, `ald`, `pld`.
</ParamField>

<ParamField body="serial_id" type="string">
  Serial identifier of the instrument
</ParamField>

## Response

<ResponseField name="synth_source_id" type="integer">
  Synthesis source identifier
</ResponseField>

<ResponseField name="source_name" type="string">
  Name of the instrument
</ResponseField>

<ResponseField name="source_makes_id" type="integer">
  ID of the source make (manufacturer and model combination)
</ResponseField>

<ResponseField name="synth_source_type" type="string">
  Synthesis source type. One of `mbe`, `pvd`, `sputter`, `cvd`, `ald`, `pld`.
</ResponseField>

<ResponseField name="source_metadata" type="object">
  Additional metadata about the instrument.

  <Expandable title="source_metadata">
    <ResponseField name="manufacture_year" type="integer">
      Year the instrument was manufactured
    </ResponseField>

    <ResponseField name="serial_identifier" type="string">
      Serial identifier of the instrument
    </ResponseField>

    <ResponseField name="inputs" type="integer">
      Number of inputs on the instrument
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="user_id" type="string">
  ID of the user who owns the instrument
</ResponseField>

<ResponseField name="last_updated" type="string">
  ISO 8601 timestamp of last update
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH "https://api.atomscale.ai/instruments/synthesis/7" \
    -H "X-API-KEY: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "MBE Chamber B"
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.patch(
      "https://api.atomscale.ai/instruments/synthesis/7",
      headers={
          "X-API-KEY": "YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "name": "MBE Chamber B"
      }
  )
  instrument = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "synth_source_id": 42,
    "source_name": "MBE Chamber B",
    "source_makes_id": 3,
    "synth_source_type": "mbe",
    "source_metadata": {
      "manufacture_year": 2021,
      "serial_identifier": "GEN10-00421",
      "inputs": 8
    },
    "user_id": "user_abc123",
    "last_updated": "2024-01-15T12:00:00Z"
  }
  ```
</ResponseExample>