> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# moorcheh namespace-create

> Create a text or vector namespace.

## Overview

Creates a new namespace for documents (`text`) or precomputed embeddings (`vector`). Prints the API response as JSON to stdout.

## Synopsis

```bash theme={null}
moorcheh namespace-create --name NAME --type text|vector [options]
```

## Options

| Flag                 | Required     | Description                             |
| -------------------- | ------------ | --------------------------------------- |
| `--name`             | Yes          | Namespace name (alphanumeric, `-`, `_`) |
| `--type`             | Yes          | `text` or `vector`                      |
| `--vector-dimension` | For `vector` | Vector length (must be > 0)             |
| `--base-url`         | No           | Default `http://localhost:8080`         |

## Examples

```bash theme={null}
moorcheh namespace-create --name my-documents --type text

moorcheh namespace-create --name my-embeddings --type vector --vector-dimension 768

moorcheh namespace-create --name my-documents --type text --base-url http://localhost:8081
```

## Output

Prints JSON from `POST /namespaces`:

<ResponseField name="status" type="string">
  `"success"` or `"failure"`.
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable result or error description.
</ResponseField>

<ResponseField name="namespace_name" type="string">
  Name of the namespace that was created.
</ResponseField>

<ResponseField name="type" type="string">
  `"text"` or `"vector"`.
</ResponseField>

<ResponseField name="vector_dimension" type="number | null">
  Fixed vector length for vector namespaces; `null` for text namespaces.
</ResponseField>

```json Example output (text) theme={null}
{
  "status": "success",
  "message": "Namespace 'my-documents' created successfully.",
  "namespace_name": "my-documents",
  "type": "text",
  "vector_dimension": null
}
```

## Exit codes

| Code | Meaning                                                                 |
| ---- | ----------------------------------------------------------------------- |
| `0`  | Namespace created                                                       |
| `1`  | API error (400, 409, 500, etc.) — error JSON printed, message on stderr |

## Related

* [API: Create namespace](/on-prem/api-references/namespaces/create)
* [Python: namespaces.create()](/on-prem/python-client/namespaces/create)