---
title: "POST /v1/namespaces/{namespace}/schema"
method: POST
path: "/v1/namespaces/{namespace}/schema"
---

# POST /v1/namespaces/{namespace}/schema

`POST /v1/namespaces/{namespace}/schema`

Update namespace schema.

## Path parameters

- `namespace` string, required

## Request body

- object — The desired schema for the namespace.

## Response `200`

The schema of the namespace.

- object — The updated schema for the namespace.

## Other responses

- `default` — An error response.

## Changes

- **2026-07-01** `42ae8d460fab` — 2 info
  - added the new optional request property `additionalProperties/anyOf[#/components/schemas/AttributeSchemaConfig]/ann/oneOf[#/components/schemas/AnnConfig]/late_interaction`
  - added the optional property `additionalProperties/ann/oneOf[#/components/schemas/AnnConfig]/late_interaction` to the response with the `200` status
- **2026-06-03** `7973861a67c5` — 1 breaking, 1 info
  - added `subschema #6` to the `additionalProperties/full_text_search/oneOf[#/components/schemas/FullTextSearchConfig]/tokenizer` response property `oneOf` list for the response status `200`
  - added `subschema #6` to the `additionalProperties/anyOf[#/components/schemas/AttributeSchemaConfig]/full_text_search/oneOf[#/components/schemas/FullTextSearchConfig]/tokenizer` request property `oneOf` list
- **2026-05-29** `a3a2adf34b95` — 2 info
  - added the new optional request property `additionalProperties/anyOf[#/components/schemas/AttributeSchemaConfig]/embed`
  - added the optional property `additionalProperties/embed` to the response with the `200` status
- **2026-04-29** `ffde0a5977cc` — 2 info
  - added the new optional request property `additionalProperties/anyOf[#/components/schemas/AttributeSchemaConfig]/sparse_knn`
  - added the optional property `additionalProperties/sparse_knn` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/turbopuffer/apis/turbopuffer-api/changes/v1/namespaces/:namespace/schema/post.md)

---

[API](https://skmtc.dev/turbopuffer/apis/turbopuffer-api.md) · [All operations](https://skmtc.dev/turbopuffer/apis/turbopuffer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/turbopuffer/turbopuffer-api/revisions/245e887f04ab/schema)