---
title: "Patch collection instrument by instrument ID"
method: PATCH
path: "/collection-instrument-api/1.0.2/{instrument_id}"
tags: ["collection-instrument"]
---

# Patch collection instrument by instrument ID

`PATCH /collection-instrument-api/1.0.2/{instrument_id}`

## Request

- Base URL: `https://localhost:8002`
- URL: `https://localhost:8002/collection-instrument-api/1.0.2/{instrument_id}`
- Auth: HTTP basic

## Path parameters

- `instrument_id` string, uuid, required

## Response `200`

Returns the collection instrument matching the instrument ID

## Other responses

- `400`: Request error (not found, missing filename, not a seft instrument)
- `500`: An external service returned a HTTPError
- `503`: An external service returned a connection error
- `504`: An external service timed out

## Changes

- **2023-02-27** `a428925d8ba4`: 3 info
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
  - added the non-success response with the status `504`
- **2021-10-05** `7f8f1464c52a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument/changes/collection-instrument-api/1.0.2/:instrument_id/patch.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument/revisions/8897fbcfad31?raw)