---
id: runtime-configuration-create
title: "Create a runtime configuration"
description: "Creates an runtime configuration."
sidebar_label: "Create a runtime configuration"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/api/nullplatform-api
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 a runtime configuration"}
>
</Heading>

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



Creates an runtime configuration.
>
> ⚠️ **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":"The runtime configuration body for updates,","required":["nrn","dimensions","values"],"properties":{"nrn":{"type":"string","description":"NRN (at or below) where the runtime configuration applies.","example":"organization=1:account=2:namespace=3:application=4"},"dimensions":{"type":"object","example":{"environment":"production"},"description":"The set of dimension/value pairs that this runtime configuration applies to.\n> You can send an empty object `{}` to create a runtime configuration that applies to all dimensions.\n"},"values":{"type":"object","example":{"global-key":"global-value","my-namespace":{"namespace-key":"namespace-value"}},"description":"The set of values that this runtime configuration holds."}},"example":{"nrn":"organization=1:account=2:namespace=3","dimensions":{"environment":"production","country":"us"},"values":{"aws":{"log_reader":"...","workflow_role":"..."}}},"title":"RuntimeConfigurationCreate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["id","nrn","profile","status","dimensions"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the runtime configuration.","example":1234},"nrn":{"type":"string","description":"NRN (at or below) where the runtime configuration applies.","example":"organization=1:account=2:namespace=3:application=4"},"profile":{"type":"string","description":"An identifier for this runtime configuration based on the dimensions on which it was created.","example":"environment_dev_country_arg"},"status":{"type":"string","description":"The status of the runtime configuration.","enum":["active","inactive"],"example":"active"},"dimensions":{"type":"object","example":{"environment":"production"},"description":"The set of dimension/values that this runtime configuration is providing values for."},"values":{"type":"object","example":{"global-key":"global-value","my-namespace":{"namespace-key":"namespace-value"}},"description":"The set of values that this runtime configuration holds."}},"example":{"id":1234,"nrn":"organization=1:account=2:namespace=3","profile":"environment_dev_country_arg","status":"active","dimensions":{"environment":"dev","country":"arg"},"values":{"workflow":"null_dev","aws":{"log_reader":"..."}}},"title":"runtime_configuration"}}}},"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>