API Changelog - 2023.03.01 - 2022.09.21

2023.03.01

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.

---

2023.01.18

January 18, 2023

• The icon attribute on Mattertags may now be read and patched. Please see the 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

---

2022.12.14

December 14, 2022

• 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

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
    }
  }
}

---

2022.12.14

December 14, 2022

Account API

API Changes

• Making access query in user.schema to be beta

query {
  organization {
    memberships {
      results {
        user(id: "$userId") {
          access(
            filters: [FolderCreator, FolderShares]
            orderBy: ROLE
            sortOrder: desc
          ) {
            results {
              email
              type
              name
              role
            }
            nextOffset
          }
        }
      }
    }
  }
}

---

2022.11.16

November 16, 2022

• Folder API query for modelCountSummary is now out of @beta

---

2022.11.16

November 16, 2022

Account API

API Changes

• Account Membership search now filters out banned users
• Account Membership search now allows us to query email, lastName, firstName

# Get memberships on an org with emails that contain matterport
query {
  organization {
    id
    memberships(field: email, query: "matterport") {
      results {
        user {
          id
          email
        }
        status
      }
    }
  }
}

• We added the ability to order membership search results

# Membership search with ordering
query {
  organization {
    id
    memberships(
      field: email
      query: "matterport"
      sortBy: [
        { field: last_name, order: desc }
        { field: first_name }
        { field: last_login, order: asc }
      ]
    ) {
      results {
        user {
          id
          email
          lastName
          lastLogin
          firstName
        }
        status
      }
    }
  }
}

Bug Fixes and Other Enhancements

• fixed the query field for org/account memberships

---

2022.10.26

October 26, 2022

• Folder extensions now out of @beta
• Webhook Mutations now available. (Enterprise only)

mutation {
  addModelEventWebhookCallback(ModelEventCallbackInput) { ... }
}

mutation {
  patchModelEventWebhookCallback(
    id: ID!,
    input: ModelEventCallbackInput
  ): ModelEventWebhookCallback
}

mutation {
  removeModelEventWebhookCallback(id: ID!): Boolean
}

mutation {
  pingModelEventWebhookCallback(id: ID!): Boolean
}

mutation {
  addModelEventToCallback(
    id: ID!,
	eventTypes: [ModelEventType!]
  ): ModelEventWebhookCallback
}

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

---

2022.10.26

October 26, 2022

Account API

• Sandbox mode is now blocked on the Account API because there is no specific behavior for this mode on this API.

• folderShares and folderShareAccessLevels queries no longer beta

---

2022.10.12

October 12, 2022

This changes the default serialization of fields with errors or no data from being left out of the response to serializing null explicitly (this is more compliant with the GraphQL standard). There is a graph query which may be used to opt an org out of this behavior to the previous behaviour:

query getSerialization($orgId: ID) {
  organization(id: $orgId) {
    id
    developer {
      options {
        serializeGraphNulls
      }
    }
  }
}

mutation disableSerializeNulls($orgId: ID) {
  patchDeveloperOptions(organizationId: $orgId, serializeGraphNulls: disabled) {
    serializeGraphNulls
  }
}

mutation enableSerializeNulls($orgId: ID) {
  patchDeveloperOptions(organizationId: $orgId, serializeGraphNulls: enabled) {
    serializeGraphNulls
  }
}

Bug Fixes and Other Enhancements

• Fixed a bug where the query to get the organization’s root folder was not returning results.

---

2022.09.21

September 21, 2022

• Mattertag description max length increased from 1,000 characters to 2,000 characters

---