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

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# Namespaces

> Namespaces auflisten, abrufen, anlegen und löschen: benannte Dokumentmengen wie docs oder user-42.

Ein Namespace ist eine benannte Menge von Dokumenten; der erste Schreibvorgang legt ihn an, und ein Namespace pro Nutzer hält die Daten der Nutzer getrennt.

## Namespaces auflisten

`GET /namespaces`

```bash curl theme={null}
curl "https://api.conare.ai/namespaces?prefix=user-" \
  -H "Authorization: Bearer $CONARE_API_KEY"
```

```ts TypeScript theme={null}
await conare.namespaces({ prefix: "user-" });
```

```json Response theme={null}
{
  "namespaces": [
    {
      "name": "user-42",
      "documents": 2,
      "embedding_model": "conare-embed-1",
      "rerank_model": "conare-rerank-1",
      "created_at": "2026-10-21T21:38:52.859567Z",
      "updated_at": "2026-10-21T21:38:52.895Z",
      "last_query_at": "2026-10-21T21:38:54.56266Z"
    }
  ]
}
```

| Option | Typ | Funktion |
| - | - | - |
| `prefix` | string | Nur Namespaces, deren Namen damit beginnen |

| Feld | Bedeutung |
| - | - |
| `name`, `documents` | Der Namespace und wie viele Dokumente er enthält |
| `embedding_model`, `rerank_model` | Die Modelle, die er verwendet |
| `created_at` | Wann er angelegt wurde; vor dem 18.10.2026, wann sein ältestes Dokument geschrieben wurde (`null`, wenn er keines enthält) |
| `updated_at` | Sein letzter Schreibvorgang |
| `last_query_at` | Seine letzte Suche, höchstens einmal pro Minute erfasst; `null`, wenn seit dem 18.10.2026 nicht durchsucht |

Vollständiges Schema: [Namespaces auflisten](https://docs.conare.ai/de/api-reference/namespaces/list-namespaces.md).

## Einen Namespace abrufen

`GET /namespaces/:namespace`

Gibt einen Namespace mit denselben Feldern zurück, oder `404 namespace_not_found`.

```bash curl theme={null}
curl https://api.conare.ai/namespaces/user-42 \
  -H "Authorization: Bearer $CONARE_API_KEY"
```

Vollständiges Schema: [Einen Namespace abrufen](https://docs.conare.ai/de/api-reference/namespaces/get-a-namespace.md).

## Einen Namespace anlegen

`POST /namespaces`

Nur für ein Modell nötig, das für Ihre Organisation trainiert wurde: Legen Sie den Namespace vor seinem ersten Schreibvorgang an.

```bash curl theme={null}
curl https://api.conare.ai/namespaces \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "contracts", "embedding_model": "<your model id>"}'
```

| Option | Typ | Funktion |
| - | - | - |
| `name` | string, erforderlich | 1-64 Zeichen aus `a-z 0-9 _ -`, beginnend mit einem Buchstaben oder einer Ziffer |
| `embedding_model` | string | Die Id Ihres [Modells](https://docs.conare.ai/de/embed-rerank.md#modelle); Standard ist `conare-embed-1` |

Gibt `name`, `embedding_model` und `rerank_model` zurück; das erneute Anlegen eines bestehenden Namespace liefert dasselbe. Vollständiges Schema: [Einen Namespace anlegen](https://docs.conare.ai/de/api-reference/namespaces/create-a-namespace.md).

## Einen Namespace löschen

`DELETE /namespaces/:namespace`

Löscht den Namespace, alle seine Dokumente und seine [hochgeladenen Dateien](https://docs.conare.ai/de/files.md); dies kann nicht rückgängig gemacht werden.

```bash curl theme={null}
curl -X DELETE https://api.conare.ai/namespaces/docs \
  -H "Authorization: Bearer $CONARE_API_KEY"
```

```ts TypeScript theme={null}
await conare.namespace("docs").drop();
```

```json Response theme={null}
{ "deleted": true, "sources_deleted": ["src_01139ca8ca59f2556f65b60e"] }
```

| Option | Typ | Funktion |
| - | - | - |
| `force` | boolean, Standard `false` | Auch die [Quellen](https://docs.conare.ai/de/sources.md) löschen, die in ihn schreiben |

* Ohne `force` gibt ein Namespace, in den eine verbundene App oder ein Bucket schreibt, `409 namespace_has_sources` zurück, mit deren Ids in `details.source_ids`.
* `sources_deleted` listet die mitgelöschten Quellen auf; `GET /sources/:id` zeigt `deleted`, sobald jede fertig ist.

Vollständiges Schema: [Einen Namespace löschen](https://docs.conare.ai/de/api-reference/namespaces/delete-a-namespace.md).


## Related topics

- [List namespaces](https://docs.conare.ai/de/api-reference/namespaces/list-namespaces.md)
- [Create a namespace](https://docs.conare.ai/de/api-reference/namespaces/create-a-namespace.md)
- [Delete a namespace](https://docs.conare.ai/de/api-reference/namespaces/delete-a-namespace.md)
- [Get a namespace](https://docs.conare.ai/de/api-reference/namespaces/get-a-namespace.md)
- [Query a namespace](https://docs.conare.ai/de/api-reference/query/query-a-namespace.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.