Create a drill map

POST {{baseUrl}}/api/model/drillMaps

Creates a new drill map in the changeset, based on the definition provided in the request body. The definition of the newly created drill map is returned in the response.

In the request body, there are two main parts:

  • Information: Stores basic drill map information such as name, subType, destinationFolderId, etc. name and destinationFolderId are required fields.
  • DrillPaths: Stores an array of drill path objects.

The changeset ID can be obtained using the changeset creation API. An authorization token is required to execute the request and can be obtained using Authentication endpoints.

To save the newly created drill map to the metadata, commit using the changeset commit API.

Request Params

KeyDatatypeRequiredDescription
showFieldsstringSpecify what additional information is returned. Only "acl" is supported.

If acl, the access control list for each object is included. |

Request Body

{"information"=>{"name"=>"Test DrillMap", "destinationFolderId"=>"{{publicReportsFolderId}}"}}

HEADERS

KeyDatatypeRequiredDescription
X-MSTR-MS-Changesetstring(Required) Authorization Token
X-MSTR-AuthTokenstring(Required) Changeset ID