OBJECT
Mutation
Data update operations.
link GraphQL Schema definition
- type Mutation {
 - #   A patch operation on a model. The id is required to identify
 - #   the model, all other attributes should only be specified if
 - #   they are intended to be changed.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - # 
 - # Arguments
 - #   id: The id of the model to retrieve.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   patch: A set of attributes to update on the model.
 - #   Only the specified fields will be updated.
 - (: ID!, : ModelIdField, : ModelPatch!): Model 
 - #   A patch operation on a floor. The IDs of the model and the floor are required to 
 - #   identify
 - #   the floor, all other attributes should only be specified if
 - #   they are intended to be changed.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #   when searching on a `field` other than `id`
 - # 
 - # Arguments
 - #   modelId: The id of the model to retrieve.
 - #   floorId: The id of the floor to patch.
 - #   field: The id field to use for the model, defaults to the 
 - #   primary identifier (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   patch: A set of attributes to update on the model.
 - #   Only the specified fields will be updated.
 - (
 - : ID!,
 - : ID!,
 - : ModelIdField,
 - : FloorPatch!
 - ): ModelFloor 
 - #   Updates all the address components.  Any components that
 - #   are unspecified will be removed from the Address, this is
 - #   not a patch operation.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #   when searching on a `field` other than `id`
 - #   @error request.invalid: If the country code is not recognized or too many 
 - #   address lines are specified.
 - # 
 - # Arguments
 - #   id: undefined
 - #   field: undefined
 - #   streetAddressLines: The street address lines.  Each line of the 
 - #   address
 - #   should be separated as a new entry in the array.
 - #   Currently only 2 address lines are supported.
 - #   administrativeArea: The administrative area, exact definition 
 - #   varies based on location, but for US addresses this is the state.
 - #   locality: The locality, exact definition varies based on 
 - #   location, but for US addresses this is the city.
 - #   dependentLocality: The dependent locality, more specific than 
 - #   city, not often used in US addresses.
 - #   postalCode: undefined
 - #   sortingCode: undefined
 - #   countryCode: Two character ISO-3166 country code.
 - (
 - : ID!,
 - : ModelIdField,
 - : [String!],
 - : String,
 - : String,
 - : String,
 - : String,
 - : String,
 - : String
 - ): Model 
 - #   Set a model to active or inactive.  Sometimes referred to as active or archived 
 - #   respectively.
 - #   If the model is already in the given state or in the process of changing to that
 - #   state this call will be idempotent.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies when searching on a `field` other than `id`
 - #   @error spaces.illegal.activation.change: If the account does not support 
 - #   archived spaces.
 - # 
 - # Arguments
 - #   id: The id of the model to retrieve.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   state: The state to set the model to, active to unarchive, 
 - #   inactive to archive.
 - (
 - : ID!,
 - : ModelIdField,
 - : ModelStateChange!
 - ): Model 
 - #   Sets whether a model can only be seen by members of the organization (internal) 
 - #   or by anyone
 - #   with a link to the model (public).
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - # 
 - # Arguments
 - #   id: The id of the model to retrieve.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   visibility: Whether the model should be public or private.
 - (
 - : ID!,
 - : ModelIdField,
 - : ModelVisibility!
 - ): Model 
 - #   Add a Label to a Model.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - #   @error request.invalid: If any of the fields in the label fail validation.
 - # 
 - # Arguments
 - #   modelId: The id of the model to add the Label to.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   label: The Label details to use for creating the Label.
 - (: ID!, : ModelIdField, : LabelDetails): Label 
 - #   A patch operation on a Label. The model id
 - #   and Label id is required to identify which
 - #   Label to patch, all other attributes should
 - #   only be specified if they are intended to be changed.
 - # 
 - #   @error not.found: If no model with the given id exists or no label with the 
 - #   given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - #   @error request.invalid: If any of the fields in the patch fail validation.
 - # 
 - # Arguments
 - #   modelId: The id of the model to patch the Label on.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   labelId: The id of the Label to patch.
 - #   patch: The patch to apply to the Label.  Only fields that
 - #   are being mutated should be specified.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!,
 - : LabelPatch!
 - ): Label 
 - #   Remove a Label from a Model.
 - #   Note if you wish to hide a label use `patchLabel(patch: { enabled: false })` 
 - #   instead.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - # 
 - # Arguments
 - #   modelId: The id of the model to delete the label from.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   labelId: The id of the Label to delete.
 - (: ID!, : ModelIdField, : ID!): Boolean 
 - # Arguments
 - #   modelId: The id of the model to add the Mattertag to.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   mattertag: The Mattertag details to use for creating the 
 - #   Mattertag
 - (
 - : ID!,
 - : ModelIdField,
 - : MattertagDetails!
 - ): Mattertag 
 - #   A patch operation on a Mattertag. The model id
 - #   and Mattertag id are required to identify which
 - #   Mattertag to patch, all other attributes should
 - #   only be specified if they are intended to be changed.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - #   @error request.invalid: If any of the fields in the patch fail validation.
 - # 
 - # Arguments
 - #   modelId: The id of the model containing the Mattertag to patch.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   mattertagId: The id of the the Mattertag to patch.
 - #   patch: undefined
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!,
 - : MattertagPatch!
 - ): Mattertag 
 - #   Sets the media associated with the Mattertag to be an external URL.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - #   @error request.invalid If url is not a valid url.
 - # 
 - # Arguments
 - #   modelId: The id of the model containing the Mattertag to patch.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   mattertagId: The id of the the Mattertag to patch.
 - #   type: The expected type of media at the given url.
 - #   url: The url to the media to retrieve.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!,
 - : MattertagMediaType,
 - : String!
 - ): Mattertag 
 - #   Removes any media associated with the Mattertag.
 - # 
 - #   @error not.found: If no model with the given id exists.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - # 
 - # Arguments
 - #   modelId: The id of the model containing the Mattertag to patch.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   mattertagId: The id of the the Mattertag to patch.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!
 - ): Mattertag 
 - #   Deletes the given Mattertag.
 - #   This call will always return true unless an unexpected error is encountered.
 - # 
 - #   @error not.found: If no model with the given id exists.  Note this will not 
 - #   happen if the
 - #  
 - #   mattertag does not exist as delete is idempotent, so attempting to delete a 
 - #   non-existent mattertag
 - #  
 - #   is ok.
 - #   @error not.unique: If multiple models with the given id exist for this 
 - #   organization. Note this only applies
 - #  
 - #   when searching on a `field` other than `id`
 - # 
 - # Arguments
 - #   modelId: The id of the model containing the Mattertag to 
 - #   delete.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   mattertagId: The id of the the Mattertag to delete.
 - (: ID!, : ModelIdField, : ID!): Boolean 
 - #   Add a new measurement path to the model.
 - # 
 - # Arguments
 - #   modelId: undefined
 - #   field: undefined
 - #   path: The measurement path definition.
 - (
 - : ID!,
 - : ModelIdField,
 - : MeasurementPathDetails!
 - ): MeasurementPath 
 - #   A patch operation on a measurement path.
 - # 
 - # Arguments
 - #   modelId: undefined
 - #   field: undefined
 - #   pathId: The identifier of the measurement path to patch.
 - #   patch: The patch to apply.  Only the attributes that to be 
 - #   modified should be set in the patch.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!,
 - : MeasurementPathPatch!
 - ): MeasurementPath 
 - #   Delete a measurement path.
 - # 
 - # Arguments
 - #   modelId: undefined
 - #   field: undefined
 - #   pathId: The identifier of the measurement path to delete.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!
 - ): Boolean 
 - #   A patch operation on a measurement.
 - # 
 - #   @deprecated Use measurementPaths instead, this field is no longer populated as 
 - #   of v2020.11.05.
 - # 
 - # Arguments
 - #   modelId: The id of the model the measurement is associated with
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   measurementId: The id of the measurement to patch.
 - #   patch: The patch to apply to the measurement.  Only fields that
 - #   are being mutated should be specified.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!,
 - : MeasurementPatch!
 - ): Measurement 
 - #   Delete a measurement.
 - # 
 - #   @deprecated Use measurementPaths instead, this field is no longer populated as 
 - #   of v2020.11.05.
 - # 
 - # Arguments
 - #   modelId: The id of the model to delete the measurement from.
 - #   field: The id field to use, defaults to the primary identifier 
 - #   (id) but may also
 - #   be a secondary identifier if that id is only applied to a single model.
 - #   measurementId: The id of the measurement to delete.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!
 - ): Boolean 
 - #   Update some of the fields associated with a Photo.
 - # 
 - #   @error not.found If there is no model or photo with the given ids.
 - # 
 - # Arguments
 - #   modelId: undefined
 - #   field: undefined
 - #   photoId: undefined
 - #   label: undefined
 - (: ID!, : ModelIdField, : ID!, : String): Photo 
 - #   Unlocks the given bundle, ordering assets or
 - #   publishing resources as needed.
 - #   This call may result in charges to your account depending on your subscription.
 - #   Success of the call means that the operation has been "approved",
 - #   there may be additional time required for the associated asset
 - #   to be generated.
 - # 
 - #   @error not.found: If no model or bundle with the given id(s) exists.
 - #   @error request.unsupported: If the bundle is not available or if the model
 - #   is in a state that prevents purchase.
 - # 
 - # Arguments
 - #   id: The id of the model to retrieve.
 - #   field: The id field to use when fetching the model.
 - #   Default: id
 - #   bundleId: The id of the bundle to unlock.
 - #   options: Additional options to use when unlocking the bundle.
 - #   Query `model(id, field) { bundle(bundleId) { supportedOptions } }` to get
 - #   any additional unlock options that are available.
 - (
 - : ID!,
 - : ModelIdField,
 - : ID!,
 - : UnlockOptions
 - ): ModelBundle 
 - #   Creates or updates the active reel with the given elements.
 - # 
 - # Arguments
 - #   modelId: undefined
 - #   field: undefined
 - #   elements: undefined
 - (
 - : ID!,
 - : ModelIdField,
 - : [ReelElementInput!]
 - ): HighlightReel 
 - }
 
    link Require by
This element is not required by anyone