Create a changeset

POST {{baseUrl}}/api/model/changesets?schemaEdit=false

Creates a new changeset. This request will return a changeset ID, which will be used in subsequent requests to read, create, and/or update objects through the modeling APIs (i.e. filters, facts, attributes, etc.). A changeset maintains an indivisible group of creations or modifications on modeling objects. Eventually the changes in the changeset should be either committed as one transaction, or abandoned altogether.

Set schemaEdit to true if this changeset ID is used to create or update schema objects through their corresponding APIs (tables, facts, attributes, hierarchies, transformations, partitions, functions). It places an exclusive_constituent lock on the schema.

A project ID and authorization token are required to execute the request. An authorization token can be obtained using Authentication endpoints.

Request Params

KeyDatatypeRequiredDescription
schemaEditbooleanSpecify whether the changeset includes the creation or update of schema objects.
Set "schemaEdit" to true if this changeset ID is used to create or update schema objects through their corresponding APIs (tables, facts, attributes, hierarchies, transformations, partitions, functions). It places an "exclusive_constituent" lock on the schema.

HEADERS

KeyDatatypeRequiredDescription
X-MSTR-AuthTokenstring(Required) Authorization Token
X-MSTR-ProjectIDstring(Required) Project ID