> ## Documentation Index
> Fetch the complete documentation index at: https://datum-4926dda5-docs-api-reference-demo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Project

> Project is the Schema for the projects API.

<Note>
  API resource reference for **Project**, part of the [Resource Manager service](/api/resource-manager/overview). To create or change one, see [Changing resources](/datumctl/resources/changing); to inspect, see [Reading resources](/datumctl/resources/reading).
</Note>

<Warning>
  This resource is part of the `v1alpha1` API and is subject to change. Fields and behavior may change in future releases.
</Warning>

## Identity

|         |                                |
| ------- | ------------------------------ |
| Group   | `resourcemanager.miloapis.com` |
| Version | `v1alpha1`                     |
| Kind    | `Project`                      |
| Scope   | Platform                       |

## Overview

A `Project` is a top-level container that groups related Datum Cloud resources — such as DNS zones, networking, and other workloads — under a single owning organization. Most Project-scoped resources live inside a Project, and you select one with the `--project` flag when reading or applying manifests. Use a Project to organize resources by team, environment, or application, all owned by an `Organization`.

## Spec fields

| Field                | Type   | Required | Description                                                      |
| -------------------- | ------ | -------- | ---------------------------------------------------------------- |
| `spec.ownerRef`      | Object | Yes      | Reference to the owner of the project. Must be a valid resource. |
| `spec.ownerRef.kind` | string | Yes      | Kind of the owning resource. Must be `Organization`.             |
| `spec.ownerRef.name` | string | Yes      | Name of the owning resource.                                     |

## Status fields (read-only)

| Field               | Type      | Description                                                                         |
| ------------------- | --------- | ----------------------------------------------------------------------------------- |
| `status.conditions` | \[]Object | Observations of the project's current state. Known condition types include `Ready`. |

## Usage

```yaml theme={null}
apiVersion: resourcemanager.miloapis.com/v1alpha1
kind: Project
metadata:
  name: my-project
spec:
  ownerRef:
    kind: Organization
    name: my-organization
```

```bash theme={null}
datumctl apply -f project.yaml
datumctl get projects
datumctl describe project my-project
```

<Tip>
  Run `datumctl explain projects --recursive` to see the full, live field tree for this resource.
</Tip>