---
id: parameter-value-create
title: "Create a single parameter value"
description: "Create a value for a parameter, either for an application or a scope."
sidebar_label: "Create a single parameter value"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/api/parameters
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 single parameter value"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/parameter/{id}/value"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Create a value for a parameter, either for an application or a scope.

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

<ParamsDetails
  parameters={[{"name":"id","in":"path","description":"The ID of the parameter.","required":true,"schema":{"type":"string"},"example":123}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","description":"A parameter value.","required":["nrn","value"],"properties":{"origin_version":{"type":"integer","description":"The ID of the parameter version. Use this field to create a new value by copying values from a specific version (i.e., roll back).\n\n> **Note**: You can retrieve the version ID by calling the [List parameter versions](/docs/api/parameter-version-list) endpoint.\n","example":1},"nrn":{"type":"string","description":"The NRN of the application or scope to which the value applies.\n\n> **Note**: For dimension settings, the NRN must be at the application-level.\n>","example":"organization=1:account=2:namespace=3:application=4:scope=5"},"value":{"type":"string","description":"The content of the value. **Cannot** exceed 2KB for environment variables and 2MB for files.","example":"200"},"dimensions":{"type":"object","description":"The dimensions of the value.","example":{"environment":"development","country":"US"}}},"title":"parameter_value_create_request"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["id","nrn","created_at"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the value.","example":1234},"nrn":{"type":"string","description":"The NRN of the application which the parameter belongs to.","example":"organization=1:account=2:namespace=3:application=4"},"created_at":{"type":"string","description":"The ISO-8601 UTC timestamp of when the parameter value was created.","format":"date-time","example":"2021-01-02T00:00:00Z"},"value":{"type":"string","nullable":true,"description":"The value of the parameter.<br><br>\n> **Note:** If `show_secret_values` is set to `true`, the value is **only visible to users with the required permission**. See [Accessing secret values](/docs/parameters/secret-visibility) for more details.\n","example":"200"},"location":{"type":"string","description":"The file path. Applicable only for files; null otherwise. Also null for secrets.","example":null},"external":{"type":"object","nullable":true,"description":"Object containing the external ID and engine of the value. \n>  **Note:** Applicable only for parameters stored in your own (external) infrastructure.\n","required":["id","engine"],"properties":{"id":{"description":"The external ID of the value.","type":"string","example":"external_id_123"},"engine":{"description":"The engine of the value. \n\n> **Note:** At the moment, only `hcp_vault` is supported.\n","type":"string","example":"hcp_vault"}}},"dimensions":{"type":"object","description":"The dimensions of the value.","example":{"environment":"development","country":"US"}}},"title":"parameter_value"}}}},"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>