---
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

## Changes

- **2026-08-27** `4e828cf153c4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zylon-ai/apis/private-gpt-api/changes/v1/files/namespaces/get.md)

---

[API](https://skmtc.dev/zylon-ai/apis/private-gpt-api.md) · [All operations](https://skmtc.dev/zylon-ai/apis/private-gpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zylon-ai/private-gpt-api/revisions/4e828cf153c4/schema)