> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/dsx-air/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/dsx-air/_mcp/server.

# air_sdk.endpoints.organizations

Stub file for organizations / resource budgets endpoint type hints.

## Attributes

| Name                                                                                   |
| -------------------------------------------------------------------------------------- |
| [`ResourceBudget`](#air_sdkendpointsorganizationsresourcebudget)                       |
| [`ResourceBudgetEndpointAPI`](#air_sdkendpointsorganizationsresourcebudgetendpointapi) |

## Classes

| Name                                                                               | Description                                                             |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [`Organization`](#air_sdkendpointsorganizationsorganization)                       | Represents an organization and its resource budget in the Air platform. |
| [`OrganizationEndpointAPI`](#air_sdkendpointsorganizationsorganizationendpointapi) | API client for Organization / ResourceBudget endpoints.                 |

## Module Contents

```python
class air_sdk.endpoints.organizations.Organization
```

**Bases**: `air_sdk.air_model.AirModel`

Represents an organization and its resource budget in the Air platform.

This model combines organization metadata with resource budget information.

```python
id: str
```

Unique identifier for the resource budget

```python
created: datetime.datetime
```

Timestamp when the resource budget was created

```python
modified: datetime.datetime
```

Timestamp when the resource budget was last modified

```python
org_display_name: str
```

Display name of the organization

```python
org_nca_id: str
```

NCA ID of the organization

```python
cpu: int | float
```

Number of CPU cores allocated

```python
memory: int | float
```

Memory allocated, in MiB

```python
disk_storage_total: int | float
```

Total disk storage allocated, in GB

```python
disk_storage_per_node: int
```

Disk storage per node, in GB

```python
image_storage: int
```

Image storage allocated, in GB

```python
userconfigs: int
```

Total UserConfig content allocated, in bytes

```python
usage: ResourceBudgetUsage
```

Current resource usage

```python
name: str
```

Organization name (alias for org\_display\_name).

```python
get_model_api() -> type[OrganizationEndpointAPI]
```

```python
model_api: OrganizationEndpointAPI
```

```python
class air_sdk.endpoints.organizations.OrganizationEndpointAPI
```

**Bases**: `air_sdk.air_model.BaseEndpointAPI[air_sdk.endpoints.organizations.Organization]`

API client for Organization / ResourceBudget endpoints.

This endpoint is read-only and provides access to organization
resource budget information.

Also aliased as ResourceBudgetEndpointAPI.

```python
API_PATH: str
```

```python
model: type[Organization]
```

```python
list(
    *,
    limit: int = ...,
    offset: int = ...,
    ordering: str = ...,
    org_display_name: str = ...,
    org_nca_id: str = ...,
    search: str = ...
) -> Iterator[Organization]
```

List all organizations / resource budgets with optional filtering.

**Parameters:**

* `limit` – Maximum number of results to return per page
* `offset` – The initial index from which to return the results
* `ordering` – Order by field. Prefix with "-" for descending order
* `org_display_name` – Filter by the display name of the organization
* `org_nca_id` – Filter by the NCA ID of the organization
* `search` – Search resource budgets by org\_display\_name

**Returns:**

Iterator of Organization instances

**Example:**

```python
>>> # List all organizations
>>> for org in api.organizations.list():
...     print(org.name, org.org_nca_id)

>>> # Filter by org_nca_id
>>> for org in api.organizations.list(org_nca_id='nca-123'):
...     print(org.name)

>>> # Search by name
>>> for org in api.organizations.list(search='NVIDIA'):
...     print(org.name)
```

```python
get(pk: PrimaryKey) -> Organization
```

Get a specific organization / resource budget by ID.

**Parameters:**

* `pk` – The resource budget ID (string or UUID)

**Returns:**

The Organization instance

**Example:**

```python
>>> org = api.organizations.get('b4d0480c-6f0b-4c40-b143-c141531fc14e')
>>> print(org.name, org.cpu, org.memory)
```

```python
ResourceBudget
```

```python
ResourceBudgetEndpointAPI
```