---
title: "Create Collection Instrument"
method: POST
path: "/collection-instruments"
---

# Create Collection Instrument

`POST /collection-instruments`

## Request

- The document declares no server URL.
- Auth: none declared

POST method to create a new collection instrument

- A GUID is required
- A validator_version is required
- A ci_version is optional, if not specified, it will increment automatically

## Query parameters

- `guid` string: guid for CI
- `validator_version` string: Validator version of CI schema
- `ci_version` string: CI version of CI schema

## Request body

- PostCiSchemaV1Data: Model for `post_ci_schema_v1` request post data This is the entire CI JSON object that you would like to publish. The example below illustrates the required attributes to put into the request body. The POST will fail if these are not included.
  - `data_version` string, required
  - `language` string, required
  - `survey_id` string, required
  - `title` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-08-28** `e82a1a49216c`: 11 breaking, 2 warning
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `ci_version` from the response with the `200` status
  - removed the required property `classifier_type` from the response with the `200` status
  - removed the required property `classifier_value` from the response with the `200` status
  - …9 more
- **2026-08-27** `1e0c2422ae94`: 10 warning, 2 info
  - removed the request property `form_type`
  - removed the request property `legal_basis`
  - removed the request property `metadata`
  - removed the request property `mime_type`
  - …8 more
- **2026-04-30** `fcb7af2e1be9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/collection-instrumentation-register/changes/collection-instruments/post.md)

---

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