---
title: "List all direktiv namespaces"
method: GET
path: "/api/v2/namespaces"
tags: ["namespaces"]
---

# List all direktiv namespaces

`GET /api/v2/namespaces`

## Response `200`

list of direktiv namespaces

- object
  - `data` object[]
    - `name` string — a unique string that represent name of the namespace
    - `isSystemNamespace` boolean — returns true only if this is a privileged namespace with special system-wide impacts.
    - `mirror` object, nullable — git mirror settings associated with the namespace (only with git mirrored namespace). Null value means this is a none mirrored (ordinary) namespace
      - `url` string — url of the git repo
      - `gitRef` string — git branch name
      - `authType` 'public' | 'ssh' | 'token' — this field indicated what kind of authentication is used
      - `publicKey` string — (optional) associated publish key ssh credential
      - `insecure` boolean — to ignore insecure ssl certificates
      - `createdAt` string — timestamp of creation date
      - `updatedAt` string — timestamp of last updating date
    - `createdAt` string — timestamp of creation date
    - `updatedAt` string — timestamp of last updating date

## Changes

- **2025-11-11** `cadb41a89182` — 1 breaking
  - the `data/items/mirror/publicKey` response's property type changed from `string(optional)` to `string` for status `200`
- **2025-11-11** `5ca26983939a` — 2 breaking
  - the response property `data/items/mirror` became nullable for the status `200`
  - the `data/items/mirror/publicKey` response's property type changed from `string` to `string(optional)` for status `200`

[Change history](https://skmtc.dev/direktiv/apis/direktiv-apiv2-reference/changes/api/v2/namespaces/get.md)

---

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