---
title: "Create namespace entry"
method: POST
path: "/v1beta1/namespaces"
tags: ["namespace"]
---

# Create namespace entry

`POST /v1beta1/namespaces`

## Request body

- V1beta1CreateNamespaceRequest
  - `id` string, required
  - `format` 'FORMAT_UNSPECIFIED' | 'FORMAT_PROTOBUF' | 'FORMAT_AVRO' | 'FORMAT_JSON'
  - `compatibility` 'COMPATIBILITY_UNSPECIFIED' | 'COMPATIBILITY_BACKWARD' | 'COMPATIBILITY_BACKWARD_TRANSITIVE' | 'COMPATIBILITY_FORWARD' | 'COMPATIBILITY_FORWARD_TRANSITIVE' | 'COMPATIBILITY_FULL' | 'COMPATIBILITY_FULL_TRANSITIVE'
  - `description` string

## Response `200`

A successful response.

- V1beta1CreateNamespaceResponse
  - `namespace` V1beta1Namespace
    - `id` string
    - `format` 'FORMAT_UNSPECIFIED' | 'FORMAT_PROTOBUF' | 'FORMAT_AVRO' | 'FORMAT_JSON'
    - `Compatibility` 'COMPATIBILITY_UNSPECIFIED' | 'COMPATIBILITY_BACKWARD' | 'COMPATIBILITY_BACKWARD_TRANSITIVE' | 'COMPATIBILITY_FORWARD' | 'COMPATIBILITY_FORWARD_TRANSITIVE' | 'COMPATIBILITY_FULL' | 'COMPATIBILITY_FULL_TRANSITIVE'
    - `description` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/raystack/apis/raystack-stencil-v1beta1-stencil-proto.md) · [All operations](https://skmtc.dev/raystack/apis/raystack-stencil-v1beta1-stencil-proto/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/raystack/raystack-stencil-v1beta1-stencil-proto/revisions/d1b228ba05f0/schema)