Namespaces

Namespaces provide logical isolation for pipelines, tables, landing zones, and other resources. Every resource belongs to exactly one namespace. The default namespace always exists and cannot be deleted.

In the Community Edition, namespaces are available but function as organizational groups (no access control). In the Pro Edition, namespaces integrate with the ACL system for multi-tenant access control.

Endpoints

List Namespaces

GET /api/v1/namespaces

Returns a list of all namespaces.

Request

curl http://localhost:8080/api/v1/namespaces

Response — 200 OK

{
  "namespaces": [
    {
      "name": "default",
      "description": "",
      "created_at": "2026-02-10T10:00:00Z"
    },
    {
      "name": "analytics",
      "description": "Analytics team namespace",
      "created_at": "2026-02-12T10:00:00Z"
    }
  ],
  "total": 2
}

Response Fields

Create Namespace

POST /api/v1/namespaces

Creates a new namespace.

Request Body

Request

curl -X POST http://localhost:8080/api/v1/namespaces \
  -H "Content-Type: application/json" \
  -d '{"name": "analytics", "description": "Analytics team namespace"}'

Response — 201 Created

{
  "name": "analytics",
  "description": "Analytics team namespace",
  "created_at": "2026-02-12T10:00:00Z"
}

Error Responses

Update Namespace

PUT /api/v1/namespaces/{name}

Updates a namespace’s description.

Path Parameters

Request Body

Request

curl -X PUT http://localhost:8080/api/v1/namespaces/analytics \
  -H "Content-Type: application/json" \
  -d '{"description": "Analytics team namespace — Q1 2026"}'

Response — 204 No Content

No response body.

Error Responses

Delete Namespace

DELETE /api/v1/namespaces/{name}

Deletes a namespace. The default namespace is protected and cannot be deleted.

Path Parameters

Request

curl -X DELETE http://localhost:8080/api/v1/namespaces/analytics

Response — 204 No Content

No response body.

Error Responses

Namespace Naming Rules