May 16, 2023

API Changes

  • A new BillingDetails under model, containing exempt: Boolean and multiSpaceUse
    • multiSpaceUse is the number of spaces counted against your space quota
    • Models on Classic Accounts or that were uploaded to accounts before entering into our new billing plans will always have a multiSpaceUse value of 1
  • The Mutation updateModelState now accepts an allowActivate boolean which defaults to false.
    • This must be set to true to unarchive models on accounts that would incur reactivation charges.
    • If this is unspecified or set to false on an account that would incur reactivation charges a request.unsupported error code will be returned.

April 6, 2023

API Changes

  • Users with Folder API Access can now query folder paths within model queries.
query getModelFolder {
  model(id: $modelId) {
    folders {
      id
      depth
    }
  }
}

March 1, 2023

API Changes

  • The assets attribute on Model is marked as nullable and documented with @error model.inactive
  • The updateModelAddress mutation supports changing the addressVisibility property.
  • The model mutation updateAddress supports changing the addressVisibility property.

Bug Fixes and Other Enhancements

  • Model Webhooks bugs have been fixed and users should receive notifications for all models in their organization.

January 18, 2023

  • The icon attribute on Mattertags may now be read and patched. Please see Tags 2.0 Icons Reference for the full icon set.
  • The floor attribute on Labels may now be queried and mutated.
  • Added ID for the resource (denoting SID of the resource) in AccessInfo type for access query

December 14, 2023

  • Folder and model api query for access now in @beta
  • The HTTP status code will be more accurate in cases where the entire graph query fails to process.
  • The error structure will also now include an additional httpStatus attribute which indicates what the equivalent HTTP status for each sub-error would have been

API Changes Example model query:

query model {
  model(id: "$modelId") {
    access(pageSize: 30, orderBy:ROLE, filters: [Admin]) {
  results {
        email
        type
        role
        name
      }
      nextOffset
    }
  }
}

Example folder query:

query folder {
  folder(id: "$folderId") {
    id
    name
    access(filters: [FolderCreator], pageSize:500) {
  results {
        email
        name
        role
        type
      }
      nextOffset
    }
  }
}

November 16, 2023

October 26, 2023

  • Folder extensions now out of @beta
  • Webhook Mutations now available. (Enterprise only)
# @beta Model Event Webhooks
#
# Add a new Model event callback for the org that the user belongs to
#
# Arguments
# input: undefined

  addModelEventWebhookCallback(
    input: ModelEventCallbackInput
  ): ModelEventWebhookCallback

# @beta Model Event Webhooks
#
# Update a Model event callback for an existing subscription
#
# Arguments
# id: undefined
# input: undefined
  patchModelEventWebhookCallback(
    id: ID!,
    input: ModelEventCallbackInput
  ): ModelEventWebhookCallback

# @beta Model Event Webhooks
#
# Remove Model event webhook callback for the org that the user belongs to
#
# Arguments
# id: Remove the model event webhook callback for the callback id
# that is provided.
# If not provided the delete all the callbacks for the organization.

  removeModelEventWebhookCallback(id: ID!): Boolean

# @beta Model Event Webhooks
#
# Ping Model event webhook callback for the org that the user belongs to.
# This will result in a callback to the registered webhook.
#
# Arguments
# id: Ping the model event webhook callback for the callback id
# that is provided.

  pingModelEventWebhookCallback(id: ID!): Boolean

# @beta Model Event Webhooks
#
# Add a model Event to webhook callback
#
# Arguments
# id: Add the model event to the webhook subscription for the
# callback id that is provided.
# eventTypes: undefined

  addModelEventToCallback(
    id: ID!,
    eventTypes: [ModelEventType!]
  ): ModelEventWebhookCallback
  
# @beta Model Event Webhooks
#
# Remove a model event from webhook subscription
#
# Arguments
# id: Remove the model event from the webhook subscription for
# the callback id that is provided.
# eventTypes: undefined

removeModelEventFromCallback(
  id: ID!,
  eventTypes: [ModelEventType!]
): ModelEventWebhookCallback