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 Mattertag
- 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 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.
- # 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 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.
- # 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 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!): 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
- # snapshotLocation: @internal
- (
- ID!, :
- ModelIdField, :
- ID!, :
- String, :
- SnapshotLocationInput :
- ): 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