---
title: "Http Post Ci Schema V3"
method: POST
path: "/v3/publish_collection_instrument"
tags: ["legacy"]
deprecated: true
---

# Http Post Ci Schema V3

`POST /v3/publish_collection_instrument`

## Request

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

> **Deprecated.**

POST method that creates a Collection Instrument in CIR.
Requires guid and validator_version as parameters with optional ci_version.
This endpoint is deprecated.

## 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** `632d6b99f82f`: 1 info
  - endpoint deprecated
- **2026-04-29** `1b29b4c8de31`: 1 info
  - api tag `legacy` added
- **2026-03-30** `671ac367d3ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/collection-instrumentation-register/changes/v3/publish_collection_instrument/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)