---
title: "Changes to Creates a namespace. Requires the admin token."
method: POST
path: "/namespaces"
---

# Changes to Creates a namespace. Requires the admin token.

`POST /namespaces`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 95 revisions.

- **2026-10-31** `aa8d1a8a5d14`: 3 breaking, 2 warning, 9 info

## Changes

- **2026-10-31** `aa8d1a8a5d14`: 3 breaking, 2 warning, 9 info
  - added the pattern `^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$` to the request property `name`
  - removed the required property `namespace/display_name` from the response with the `200` status
  - removed the required property `namespace/namespace_id` from the response with the `200` status
  - the `name` request property's maxLength was set to `63`
  - removed the request property `display_name`
  - the endpoint scheme security `rivet_token_header` was added to the API
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `409`
  - added the non-success response with the status `415`
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`

---

[Operation](https://skmtc.dev/rivet-dev/apis/rivet-api-public/docs/namespaces/post.md) - [API](https://skmtc.dev/rivet-dev/apis/rivet-api-public.md) - [Page](https://skmtc.dev/rivet-dev/apis/rivet-api-public/changes/namespaces/post)