---
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
canonical: 'https://docs.nullplatform.com/docs/api/parameter-value-create'
---
<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 32 KB for environment variables and 1 MB 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":"The request couldn't be processed. For example, a parameter is invalid, the resource doesn't exist, or you don't have permission. The body is a problem details object (RFC 9457).","content":{"application/problem+json":{"schema":{"type":"object","description":"Describes what went wrong, following the RFC 9457 problem details format.","required":["type","title","status"],"properties":{"type":{"type":"string","description":"A URI that identifies the kind of problem. It's an identifier, not a link, and it's the same every time this problem occurs.","example":"urn:nullplatform:error:routes-helper:invalid-params"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","example":"There are invalid parameters on the request"},"status":{"type":"integer","description":"The HTTP status code of the response.","example":400},"code":{"type":"string","description":"A stable, machine-readable error code. Use it to handle specific errors in your integrations.","example":"ROUTES_HELPER.INVALID_PARAMS"},"detail":{"type":"string","nullable":true,"description":"More information about what went wrong in this request, when available.","example":null},"errors":{"type":"array","description":"One entry per invalid field or parameter. Only present on validation errors.","items":{"type":"object","properties":{"field":{"type":"string","description":"The name of the invalid field or parameter.","example":"application_id"},"in":{"type":"string","description":"Where the field was sent: `body`, `query`, or `params` (path parameters).","example":"query"},"issue":{"type":"string","description":"What's wrong with the field, such as `required` or `invalid`.","example":"invalid"},"value":{"description":"The value that was sent, when relevant.","example":"not-a-number"},"message":{"type":"string","description":"A human-readable explanation of the issue."}}}},"message":{"type":"string","deprecated":true,"description":"Same value as `title`, kept for backward compatibility. Use `title` or `code` instead.","example":"There are invalid parameters on the request"},"traceId":{"type":"string","description":"An identifier for this request, when available. Include it when you contact nullplatform support."}}}}}},"5XX":{"description":"Something went wrong on nullplatform's side. The body is a problem details object (RFC 9457).","content":{"application/problem+json":{"schema":{"type":"object","description":"Describes what went wrong, following the RFC 9457 problem details format.","required":["type","title","status"],"properties":{"type":{"type":"string","description":"A URI that identifies the kind of problem. It's an identifier, not a link, and it's the same every time this problem occurs.","example":"about:blank"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","example":"Oops.. there was an internal error"},"status":{"type":"integer","description":"The HTTP status code of the response.","example":500},"code":{"type":"string","description":"A stable, machine-readable error code. Use it to handle specific errors in your integrations."},"detail":{"type":"string","nullable":true,"description":"More information about what went wrong in this request, when available.","example":null},"message":{"type":"string","deprecated":true,"description":"Same value as `title`, kept for backward compatibility. Use `title` or `code` instead.","example":"Oops.. there was an internal error"},"traceId":{"type":"string","description":"An identifier for this request, when available. Include it when you contact nullplatform support."}}}}}}}}
>

</StatusCodes>