---
title: "K8s: Namespace"
slug: "k8s-namespace"
updated: 2026-07-09T12:08:05Z
published: 2026-07-09T12:08:05Z
canonical: "resources.realtheory.io/k8s-namespace"
---

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

# K8s: Namespace

This model describes information about a Namespace and includes the raw Namespace resource as returned by the Kubernetes API.

#### Example:

```
{
    "metadata": {
        "id": "568490d7-9f0e-41ad-b416-8392056cb455",
        "name": "web-app",
        "clusterId": "f99e055f-b35d-208b-63b1-f4222b80151a",
        "clusterName": "realtheory-cluster-01",
        "owners": null,
        "timestamp": "2024-07-17T20:15:15.333644Z"
    },
    "object": {
        "metadata": {
            "name": "web-app",
            "uid": "568490d7-9f0e-41ad-b416-8392056cb455",
            "labels": {
                "kubernetes.io/metadata.name": "web-app"
            }
        },
        "spec": {
            "finalizers": [
                "kubernetes"
            ]
        },
        "status": {
            "phase": "Active"
        }
    }
}
```

**Note:** Content has been omitted from the `object` property in the JSON response above for brevity.

where:

- **metadata**
  - `id`: Represents the ID of the namespace.
  - `name`: Represents the name of the namespace.
  - `clusterId`: Represents the ID of the cluster associated with the namespace.
  - `clusterName`: Represents the name of the cluster associated with the namespace.
  - `owners`: Represents a list of owner records linked to the namespace. This value can be empty if not applicable.
  - `timestamp`: Represents the timestamp of the record.
- `object`: Represents the raw Kubernetes Namespace resource as returned by the Kubernetes API. This is a standard [Namespace](https://kubernetes.io/docs/reference/kubernetes-api/cluster-resources/namespace-v1/) object, including its full `metadata`, `spec`, and `status`. Refer to the official Kubernetes API reference for a description of its fields.