---
sidebar_label: Nullplatform Resource Name (NRN)
doc_id: 8fa9c605-e4da-48ee-b966-95381a698141
description: >-
  A hierarchical string that uniquely identifies any entity in nullplatform,
  used for authorization, configuration scoping, and event routing.
keywords:
  - NRN
  - nullplatform
  - resource identifier
  - hierarchy
  - addressing
---

# Nullplatform Resource Name (NRN)

An NRN is a hierarchical string that uniquely identifies any entity in nullplatform — similar to Amazon ARNs. NRNs encode an entity's position in the organizational hierarchy and appear throughout the platform in authorization grants, notification filters, provider configurations, and API responses.

## Format

```
organization=1:account=2:namespace=3:application=4:scope=5
```

Each segment represents a level in the hierarchy:

| Level | Example | Description |
|---|---|---|
| Organization | `organization=1` | Top-level tenant |
| Account | `organization=1:account=2` | Business unit or team |
| Namespace | `organization=1:account=2:namespace=3` | Logical grouping of applications |
| Application | `…:namespace=3:application=4` | A single deployable application |
| Scope | `…:application=4:scope=5` | A deployment target (environment) |

You can use a partial NRN to reference any level. For example, `organization=1:account=2` targets the account and everything beneath it.

## Where NRNs appear

- **Authorization grants** — scope permissions to specific levels in the hierarchy.
- **Notification filters** — route events from specific resources.
- **Provider configurations** — bind providers at any hierarchy level, with inheritance downward.
- **Parameters** — attach configuration at any level; child entities inherit parent values.
- **Banners** — target announcements to specific resources using NRNs.
- **API responses** — most entities include an `nrn` field showing their position.

## NRN API (deprecated) {#nrn-api}

:::warning Deprecation notice

The NRN API (`/nrn/:id`) is a legacy hierarchical configuration store that may be removed in the future. Use [**Providers**](./providers/overview.md) for infrastructure configuration and [**Parameters**](./parameters/parameters.md) for application runtime settings.

:::

The NRN API stored key-value configuration data keyed by NRN strings, with hierarchical merging and profile-based overrides. See the [NRN API reference](./providers/nrn-api.md) for details.