---
id: parameter-values-create
title: "Create multiple parameter values"
description: "Create multiple application or scope parameter values."
sidebar_label: "Create multiple parameter values"
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 multiple parameter values"}
>
</Heading>

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



Create multiple application or scope parameter values.

<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":"Multiple parameter values.","required":["values"],"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},"values":{"type":"array","items":{"type":"object","description":"A parameter value.","required":["nrn","value"],"properties":{"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_values_multi_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>