---
id: nrn-create
title: "Create an NRN"
description: "Creates a new NRN or replaces an existing one. **This operation overwrites any previous value.**"
sidebar_label: "Create an NRN"
hide_title: true
hide_table_of_contents: true
api: eJzlV9tuGzcQ/ZUBnxJjLSmJ87JAAjhOgrpAVcNRkAC2YYy4Iy3jXXLDi2RF2G/oe5/6Gf2e/kB/oRhyZa3sXJqiN7Qva5oaDodnzhkO16IgJ61qvDJa5OLIEnpygKBpCePTMRgLlpoKJc9qoGvlvNJzMJoGsLc3KZUD05BF9gBmQXZpVXShV9BYWigTHCywCjTY2zvX5/rpuX4Kv/z4068//wB7e8+psSTTam28ksRW0eaW71rNSw9TAku1WVABSoMvCWbBB0sDeMO/SFPXpAsIjoM8O7FmoQqy7uLesDDSDZvNxJBDXSha3gelnScsBiITN7sdFyIX2upcRkREJjzOncjPxPh0LC4yYel9IOefmWIl8rWQRnvSnofYNJVKJxq+cwzrWjhZUo088quGRC7M9B1JL7Jb+B9qSL/AsiRLcEUrx/hbcqR9TEiE0nFeGmtmqiLHgdM11k1Fcf+lG1RYTwt8GbRkx2Osec/vVpuJuO+CKtPUpH2exyVmfmkJC7KX1rAnNknDTDTWFCEu/ZQxW6RxmwmvfJwcW50YJdq2bTPhSAar/ErkZ2sxJbRkD4MvRX520UZMXWO0I8fHeDga8Z9dfCYl9RixRAcuSEnOzULFMPzhNHA6laWCM6wtA6SxJtcw79P5I9Sc+cZyBF6lMNl46895q/T8blrBrZynen+pCoKg1ftAcPwcZlFdzgQraSeLwtg5avUhhv/kQY5SmqD9k4eMbi+yryYUoSyZVVtSRbFvPGaAugDlO8WCiqLvPDC4qDQL64pW+8miQWVvM3A3wHllplhF+E1N+1e0YqB4GD101LhB+CuO1AuIC8HGBeACVYXTiiLAnsvI+HR8K8j+hj0x3MR5c4jPRN4XxhcXoja+JNs7dTz4RitMpDRz8PbtXeYfVYorAFmbOJOEAkUg8AaUXmCluCQ2wXNtqJWLFbBBizV5Sjn6U+ThPPrgjkzBhSHGIzJRk3M4p7v66Flv/SrtaU72Tmq/mUxOIK0AaQrasnSTY9eQVDMlQfbxuEeD+SCDg9GIPw/484g/B/d3kn4wGrUMwk4sn5RsjbJUmva5zkUypb1iXL5EDxI9zY1VH8il2MguyMIMVcUX0o6ep1hcdlcG0ybB9juCmFpFswzKUKPeRtKzAjOLm6fg2N0GjXPxDAs4TZueC554rTH4MoZcnItdcPrWHOImo18OsigUD7GCgjyqygFOTfDbsHb34RreQREreI3VzNiaCojoRknH2z1Rus/gjWYef0whrxL8txWidBF5rudcypRzgcCkzuHw5BicKug/Jg3XB6Ijw2OWxuPRQ/482k38439OFXxYq7G6TEaXCbK/TR/H3fbQUecF2ySl8IySBK/1zWVyRzAfXf6XSudQQ9B03ZD0VHRHMlIGa6kYwElF6Ai8XQHOUWmo0JMdbK+amnxpuLFtjGPqNsi9lximhiflwMXeLNhK5KL0vnH5cIiNGuhQVU2FnqU6kKYW3LBt+rlXrI5E6n5Xd3N8dsQ7RDOuhtFIZN3gpbE1epGLb99MBAfKqjvdNtgv/lXNrdIzw6EwWCmNDwajwUj02t7TcewNjPM16k1HdPO84jrEJrfY0HtE/O/fYR1vPF37YVOh0oxnJOW6Y21q0y8yUTKX8zOxXk/R0WtbtS1Pvw9k+Z1xkYkFWsUCjs+MTJQxtZHmqTE7SrDvT3hTNuf+LL97DbTZZsWhlNT4z9pe9OR28v2rCZO9eyvWsdQKi0u+PnApchGfnrw6aijOrUWFeh5iHRHJJ0sDd5V1S0nxVN1PqFe9CNfrZDExV6TbVmTdUTz/L9qLtm1/A1fwocY=
sidebar_class_name: "post api-method"
info_path: docs/api/nrn
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create an NRN"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/nrn"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Creates a new NRN or replaces an existing one. **This operation overwrites any previous value.**

>
> ⚠️ **Deprecation notice**
>
> This operation might be removed in the future. We recommend using [Providers](/docs/providers/overview) instead.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","description":"An object where keys represent NRN values or profiles.","example":{"aws.lambdaFunctionName":"MyFunction","development::aws.log_reader_role":"dev_role","production::aws.log_reader_role":"prod_role"},"title":"NrnCreate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["nrn","namespaces","profiles"],"properties":{"nrn":{"type":"string","description":"A system-wide unique ID for resource.","example":"organization=1:account=2"},"namespaces":{"type":"object","description":"An object where each key represents a namespace, and its value is an object containing key-value pairs.","example":{"namespaces":{"global":{"some-key":"some-value"}}}},"profiles":{"type":"object","description":"An object containing the profiles available for this NRN.","example":{"profiles":{"development":{"some-namespace":{"some-key":"some-value"},"production":{"some-namespace":{"some-key":"another-value"}}}}}}},"title":"nrn"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>