---
title: "Changes to Create a new namespace"
method: POST
path: "/v1/namespace/{id}/create"
---

# Changes to Create a new namespace

`POST /v1/namespace/{id}/create`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 70 revisions.

- **2026-07-01** `591cd95574b0`: 9 info
- **2026-01-02** `83f8516f0507`: 1 info
- **2026-01-01** `c987c26ccb0f`: 1 info
- **2025-12-20** `5d6099d672d3`: 8 breaking, 8 warning, 8 info
- **2025-12-11** `62ebe0595c5f`: 3 breaking
- **2025-12-11** `6ad4337e3849`: 1 info
- **2025-08-20** `29b677664883`: 3 breaking, 3 info
- **2025-07-29** `40a3bc489d46`: 8 breaking, 16 warning, 16 info
- **2025-07-25** `8769f8e36bc4`: 1 breaking, 4 warning, 3 info
- **2025-07-22** `ac7519693c52`: 1 info
- **2025-07-21** `db7569410aa4`: 1 info
- **2025-07-20** `a844e2317988`: 1 info
- **2025-07-03** `d09d72ed3832`: 1 info

## Changes

- **2026-07-01** `591cd95574b0`: 9 info
  - added the optional property `context` to the response with the `200` status
  - added the optional property `context` to the response with the `400` status
  - added the optional property `context` to the response with the `401` status
  - added the optional property `context` to the response with the `403` status
  - added the optional property `context` to the response with the `404` status
  - added the optional property `context` to the response with the `406` status
  - added the optional property `context` to the response with the `409` status
  - added the optional property `context` to the response with the `503` status
  - added the optional property `context` to the response with the `5XX` status
- **2026-01-02** `83f8516f0507`: 1 info
  - added the new optional request property `context`
- **2026-01-01** `c987c26ccb0f`: 1 info
  - added the new optional request property `identity`
- **2025-12-20** `5d6099d672d3`: 8 breaking, 8 warning, 8 info
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `400`
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `401`
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `403`
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `404`
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `406`
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `409`
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `503`
  - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `5XX`
  - removed the optional property `type` from the response with the `400` status
  - removed the optional property `type` from the response with the `401` status
  - removed the optional property `type` from the response with the `403` status
  - removed the optional property `type` from the response with the `404` status
  - removed the optional property `type` from the response with the `406` status
  - removed the optional property `type` from the response with the `409` status
  - removed the optional property `type` from the response with the `503` status
  - removed the optional property `type` from the response with the `5XX` status
  - the response property `code` became required for the status `400`
  - the response property `code` became required for the status `401`
  - the response property `code` became required for the status `403`
  - the response property `code` became required for the status `404`
  - the response property `code` became required for the status `406`
  - the response property `code` became required for the status `409`
  - the response property `code` became required for the status `503`
  - the response property `code` became required for the status `5XX`
- **2025-12-11** `62ebe0595c5f`: 3 breaking
  - removed the enum value `create` of the request property `mode`
  - removed the enum value `exist_ok` of the request property `mode`
  - removed the enum value `overwrite` of the request property `mode`
- **2025-12-11** `6ad4337e3849`: 1 info
  - added the optional property `transaction_id` to the response with the `200` status
- **2025-08-20** `29b677664883`: 3 breaking, 3 info
  - removed the enum value `CREATE` of the request property `mode`
  - removed the enum value `EXIST_OK` of the request property `mode`
  - removed the enum value `OVERWRITE` of the request property `mode`
  - added the new `create` enum value to the request property `mode`
  - added the new `exist_ok` enum value to the request property `mode`
  - added the new `overwrite` enum value to the request property `mode`
- **2025-07-29** `40a3bc489d46`: 8 breaking, 16 warning, 16 info
  - the response property `type` became optional for the status `400`
  - the response property `type` became optional for the status `401`
  - the response property `type` became optional for the status `403`
  - the response property `type` became optional for the status `404`
  - the response property `type` became optional for the status `406`
  - the response property `type` became optional for the status `409`
  - the response property `type` became optional for the status `503`
  - the response property `type` became optional for the status `5XX`
  - removed the optional property `status` from the response with the `400` status
  - removed the optional property `status` from the response with the `401` status
  - removed the optional property `status` from the response with the `403` status
  - removed the optional property `status` from the response with the `404` status
  - removed the optional property `status` from the response with the `406` status
  - removed the optional property `status` from the response with the `409` status
  - removed the optional property `status` from the response with the `503` status
  - removed the optional property `status` from the response with the `5XX` status
  - removed the optional property `title` from the response with the `400` status
  - removed the optional property `title` from the response with the `401` status
  - removed the optional property `title` from the response with the `403` status
  - removed the optional property `title` from the response with the `404` status
  - removed the optional property `title` from the response with the `406` status
  - removed the optional property `title` from the response with the `409` status
  - removed the optional property `title` from the response with the `503` status
  - removed the optional property `title` from the response with the `5XX` status
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `406` status
  - added the optional property `code` to the response with the `409` status
  - added the optional property `code` to the response with the `503` status
  - added the optional property `code` to the response with the `5XX` status
  - added the optional property `error` to the response with the `400` status
  - added the optional property `error` to the response with the `401` status
  - added the optional property `error` to the response with the `403` status
  - added the optional property `error` to the response with the `404` status
  - added the optional property `error` to the response with the `406` status
  - added the optional property `error` to the response with the `409` status
  - added the optional property `error` to the response with the `503` status
  - added the optional property `error` to the response with the `5XX` status
- **2025-07-25** `8769f8e36bc4`: 1 breaking, 4 warning, 3 info
  - removed the required property `name` from the response with the `200` status
  - removed the request property `name`
  - removed the request property `options`
  - removed the request property `parent`
  - removed the optional property `parent` from the response with the `200` status
  - added the new optional request property `id`
  - added the new optional request property `properties`
  - the request property `mode` became optional
- **2025-07-22** `ac7519693c52`: 1 info
  - the request property `name` became optional
- **2025-07-21** `db7569410aa4`: 1 info
  - api tag `Metadata` added
- **2025-07-20** `a844e2317988`: 1 info
  - added the non-success response with the status `404`
- **2025-07-03** `d09d72ed3832`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lance-format/apis/lance-namespace-specification/docs/v1/namespace/:id/create/post.md) - [API](https://skmtc.dev/lance-format/apis/lance-namespace-specification.md) - [Page](https://skmtc.dev/lance-format/apis/lance-namespace-specification/changes/v1/namespace/:id/create/post)
