Skip to main content

instances Query

Returns a Relay Connection to a collection of Instance objects.

Access is permitted when any of the following condition(s) are met: 1. The signed-in User has any of the following permissions for the associated Organization: [org_admin_instance_permissions, org_manage_instances, org_view_instances]. 2. The signed-in User has any of the following permissions for the object: [instance_admin_permissions, instance_view, instance_edit, instance_remove]. 3. The signed-in User has any of the following permissions for the object's 'customer' attribute: [customer_admin_instance_permissions, customer_view_instances, customer_manage_marketplace_integrations]. 4. The signed-in User has any of the following permissions for the object's 'customer' attribute: [customer_access_marketplace_integrations]. 5. The signed-in User has any of the following permissions for the object's 'integration' attribute: [integration_admin_permissions, integration_view, integration_edit, integration_remove]. 6. The signed-in User has any of the following permissions for the object's 'integration_Customer' attribute: [customer_admin_manage_instances, customer_admin_integration_permissions, customer_manage_integrations].

Input fields

ArgumentTypeDescription
isSystemBooleanFilter for system-generated Instances.
compatibilityIntOpt in to new behavior.
beforeStringSpecifies a cursor for use in combination with last to implement backward pagination.
afterStringSpecifies a cursor for use in combination with first to implement forward pagination.
firstIntA non-negative integer that specifies to return at most first edges after the after cursor.
lastIntA non-negative integer that specifies to return at most last edges before the before cursor.
offsetInt
name_IcontainsStringFilter for objects where name contains the specified value (case insensitive).
nameStringFilter for objects where name matches the specified value.
description_IcontainsStringFilter for objects where description contains the specified value (case insensitive).
descriptionStringFilter for objects where description matches the specified value.
integrationIDFilter for objects where integration matches the specified ID.
customerIDFilter for objects where customer matches the specified ID.
customer_ExternalIdStringFilter for objects where customer.externalId matches the specified value.
enabledBooleanFilter for objects where enabled matches the specified value.
needsDeployBooleanFilter for objects where needsDeploy matches the specified value.
createdAt_GteDateTimeFilter for objects where createdAt occurs on or after the specified value.
createdAt_LteDateTimeFilter for objects where createdAt occurs on or before the specified value.
updatedAt_GteDateTimeFilter for objects where updatedAt occurs on or after the specified value.
updatedAt_LteDateTimeFilter for objects where updatedAt occurs on or before the specified value.
integration_VersionSequenceIdUUIDFilter for objects where integration.versionSequenceId matches the specified value.
labels_IcontainsStringFilter for objects where labels contains the specified value (case insensitive).
labels_ContainsStringFilter for objects where labels contains the specified value (case sensitive).
orderByInstanceOrderDEPRECATED. Prefer using sort_by instead as it allows ordering by many fields.
sortBy[InstanceOrder]Allows specifying many field and direction pairs to sort results by.

Return fields (InstanceConnection!)

edges ([InstanceEdge]!)

List of edges containing the nodes in this connection.

nodes ([Instance]!)

List of nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total count of nodes available.