---
title: "List namespaces"
method: GET
path: "/v1/files/namespaces"
tags: ["files"]
---

# List namespaces

`GET /v1/files/namespaces`

List all registered filesystem namespaces and their local roots. Namespaces are configured under `filesystems.namespaces` in settings; well-known names include 'session' and 'skills'; additional namespaces may be added in settings.

## Response `200`

Successful Response

- NamespaceListResponse — List of registered filesystem namespaces.
  - `data` NamespaceInfo[] — Registered namespaces, sorted alphabetically by name.
    - `name` string, required — Logical namespace name (e.g. 'session', 'skills', or a custom name).
    - `root` string, required — Absolute local path that backs this namespace.
    - `default_mode` 'rw' | 'ro', required — Default access mode: 'rw' (read-write) or 'ro' (read-only).

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/privategpt/apis/api-reference.md) · [All operations](https://skmtc.dev/privategpt/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/privategpt/api-reference/revisions/15d9ccfd68da/schema)