---
title: "Post Schema"
method: POST
path: "/v1/schema"
deprecated: true
---

# Post Schema

`POST /v1/schema`

## Request

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

> **Deprecated.**

Posts the schema metadata to be processed.

Parameters:
survey_id (str): survey_id of the schema
schema (dict): schema to be processed in JSON format.
schema_processor_service (SchemaProcessorService): injected processor service for processing the schema.

## Query parameters

- `survey_id` string, required

## Request body

- object

## Response `200`

Successful Response

- SchemaMetadata
  - `survey_id` string, required
  - `schema_location` string, required
  - `sds_schema_version` integer, required
  - `sds_published_at` string, required
  - `schema_version` string, required
  - `title` string, required
  - `guid` string, required

## Other responses

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

## Changes

> 32 revisions in range; 2 not diffed.

- **2026-07-01** `9a87e51baf13`: 2 info
  - api operation id `post_schema_v1_schema_post` removed and replaced with `Post_Schema_v1_schema_post`
  - endpoint deprecated
- **2023-09-07** `09c30581ada9`: 1 info
  - added the required property `title` to the response with the `200` status
- **2023-08-25** `ac59298eeeb5`: 1 breaking, 4 info
  - added required request body
  - api operation id `post_schema_v1_schema_post` was added
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - …1 more
- **2023-08-08** `f61f035501a7`: 1 breaking
  - added the new required `query` request parameter `survey_id`

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/changes/v1/schema/post.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/revisions/9a87e51baf13?raw)