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

# Organization

> Organization is the Schema for the Organizations API.

<Note>
  API resource reference for **Organization**, 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    | `Organization`                 |
| Scope   | Platform                       |

## Overview

An `Organization` is the top-level container in Datum Cloud that owns projects, members, and billing. Because it is Platform-scoped, it exists across the whole platform rather than inside a single project. Use it to establish an organizational boundary — either a `Personal` organization tied to an individual account, or a `Standard` organization for a team or company.

## Spec fields

| Field       | Type   | Required | Description                                                |
| ----------- | ------ | -------- | ---------------------------------------------------------- |
| `spec.type` | string | Yes      | The type of organization. One of `Personal` or `Standard`. |

## Status fields (read-only)

| Field                       | Type      | Description                                                                              |
| --------------------------- | --------- | ---------------------------------------------------------------------------------------- |
| `status.conditions`         | \[]Object | Observations of the organization's current state. Known condition types include `Ready`. |
| `status.observedGeneration` | integer   | The most recent generation observed for this Organization by the controller.             |

## Usage

```yaml theme={null}
apiVersion: resourcemanager.miloapis.com/v1alpha1
kind: Organization
metadata:
  name: acme
spec:
  type: Standard
```

```bash theme={null}
datumctl apply -f organization.yaml
datumctl get organizations
datumctl describe organization acme
```

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