---
title: "Create a namespace"
method: POST
path: "/api/user/namespace/create"
tags: ["registry-api"]
---

# Create a namespace

`POST /api/user/namespace/create`

## Request body

- Namespace — Metadata of a namespace
  - `success` string — Indicates success of the operation (omitted if a more specific result type is returned)
  - `warning` string — Indicates a warning; when this is present, other properties can still be used
  - `error` string — Indicates an error; when this is present, all other properties should be ignored
  - `name` string, required — Name of the namespace
  - `extensions` object — Map of extension names to their metadata URLs (not required for creating)
  - `verified` boolean, required — Indicates whether the namespace has an owner (not required for creating)
  - `access` 'public' | 'restricted' — Access level of the namespace. Deprecated: namespaces are now always restricted

## Response `201`

Successfully created the namespace

- Result — Generic result indicator
  - `success` string — Indicates success of the operation (omitted if a more specific result type is returned)
  - `warning` string — Indicates a warning; when this is present, other properties can still be used
  - `error` string — Indicates an error; when this is present, all other properties should be ignored

## Other responses

- `400` — The namespace could not be created
- `403` — User is not logged in
- `429` — A client has sent too many requests in a given amount of time

---

[API](https://skmtc.net/livesession/apis/open-vsx-registry-api.md) · [All operations](https://skmtc.net/livesession/apis/open-vsx-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/livesession/open-vsx-registry-api/versions/badd706d3136/schema)