Update a data model parameter

Available since Strategy (May 2026)

This workflow sample demonstrates how to update a parameter that belongs to a data model using the REST API.

info

Get the authorization token needed to execute the request with POST /api/auth/login.

Get the project ID from GET /api/projects.

tip

Changesets are used in this workflow. For information on how to create and use changesets, see Changesets.

Endpoint: PUT /api/model/dataModels/{dataModelId}/parameters/{parameterId}

Sample Request

• Request Headers

'Content-Type: application/json'
'Accept: application/json'
'X-MSTR-AuthToken: pk2dudliaoqh5hmv240ururl82'
'X-MSTR-ProjectID: B7CA92F04B9FAE8D941C3E9B7E0CD754'
'X-MSTR-MS-Changeset: 768A0AA9E94547218BA930DD4245186B'

• Request Body

The example below updates the parameter's name, title, instruction, default answer, and restriction range.

{
  "information": {
    "objectId": "E6CD1AA47E5A4DB7B23EDAA6FBC07578",
    "destinationFolderId": "FB63EDEB81474D2DB675CA7E865F814E",
    "subType": "prompt_double",
    "name": "Region Range Prompt"
  },
  "title": "Region",
  "instruction": "Enter a region.",
  "defaultAnswer": {
    "value": 202005
  },
  "restriction": {
    "min": 1,
    "max": 202512
  }
}

• Curl

curl -L -X PUT 'http://demo.microstrategy.com/MicroStrategyLibrary/api/model/dataModels/3A82F20B2CC849B0970B289C86D8C83C/parameters/E6CD1AA47E5A4DB7B23EDAA6FBC07578' \
-H 'X-MSTR-AuthToken: pk2dudliaoqh5hmv240ururl82' \
-H 'X-MSTR-ProjectID: B7CA92F04B9FAE8D941C3E9B7E0CD754' \
-H 'X-MSTR-MS-Changeset: 768A0AA9E94547218BA930DD4245186B' \
-H 'Content-Type: application/json' \
-d '{
  "information": {
    "objectId": "E6CD1AA47E5A4DB7B23EDAA6FBC07578",
    "destinationFolderId": "FB63EDEB81474D2DB675CA7E865F814E",
    "subType": "prompt_double",
    "name": "Region Range Prompt"
  },
  "title": "Region",
  "instruction": "Enter a region.",
  "defaultAnswer": {
    "value": 202005
  },
  "restriction": {
    "min": 1,
    "max": 202512
  }
}'

Sample Response

• Response Body:

{
  "information": {
    "versionId": "941BA80ADC7347E3B2E4923BB3486F62",
    "acg": 255,
    "primaryLocale": "en-US",
    "objectId": "E6CD1AA47E5A4DB7B23EDAA6FBC07578",
    "subType": "prompt_double",
    "name": "Region Range Prompt",
    "destinationFolderId": "FB63EDEB81474D2DB675CA7E865F814E"
  },
  "defaultAnswer": {
    "value": 202005.0
  },
  "restriction": {
    "min": 1.0,
    "max": 202512.0,
    "interval": 1.0,
    "allowedValueType": "range"
  }
}

• Response Code: 200 (Success: OK)