Gaiia.Queries (Gaiia v0.2.0)

Copy Markdown View Source

Auto-generated functions for every query operation in the Gaiia GraphQL API.

Each function has the signature:

<name>(client, variables \\ %{}, selection \\ "", opts \\ [])
  :: {:ok, map() | term()} | {:error, Gaiia.Error.t()}

Arguments:

  • client — a Gaiia.Client struct (build with Gaiia.Client.new/1)
  • variables — map of variables matching the GraphQL argument names (camelCase, string keys). Only keys present in this map are sent.
  • selection — selection-set body (no surrounding braces). Required for object return types; pass "" for scalar return types.
  • opts — forwarded to Gaiia.Client.query/4 (e.g. :operation_name)

Return value is the contents of the named field, unwrapped from the data envelope — i.e. Gaiia.Queries.account(client, %{"id" => id}, "id") returns {:ok, %{"id" => "..."}}, not {:ok, %{"account" => %{"id" => "..."}}}.

Summary

Functions

Query a paginated list of account custom field definitions.

Query accounts in network sites by traversing device hierarchy.

Query a paginated list of address custom field definitions.

Retrieve the tenant's appointment settings, with arrival windows resolved for an optional work type.

Query paginated list of archived product bundles.

Query a paginated list of archived coverage areas.

Query availabilities for auto-assignment with travel time constraints.

Query a paginated list of technicians available for a work order on a specified date.

Query a paginated list of billing subscriptions. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

Query paginated list of product bundles.

Query a paginated list of cancellation reasons.

Query a paginated list of commercial account statuses.

Query a paginated list of commercial accounts. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query the full list of Communication Type Groups, ordered for display.

List all custom object definitions for the tenant. The arguments first and last are mutually exclusive; only one can be set at a time. The same applies to after and before.

Fetch a single custom object field definition by id.

List all field definitions for a custom object. The arguments first and last are mutually exclusive; only one can be set at a time. The same applies to after and before.

List records for a custom object type. The arguments first and last are mutually exclusive; only one can be set at a time. The same applies to after and before.

Query a paginated list of customer owned items.

Get entity custom field definitions for a specific entity type.

Query a paginated list of incident procedure templates.

Query a paginated list of billing invoices. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

Get a paginated list of notifications. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query a paginated list of order attribution profiles. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query a paginated list of orders. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query a paginated list of payment methods. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

Query the PIN verification status for an entity.

Preview the schedule events that would be generated from an existing schedule template.

Retrieve a product availability job by its ID. Requires a gaiia publishable key in the request headers.

Get a product by slug. If the slug is not current, attempts to resolve it using product slug history.

Evaluates product version and bundle eligibility against a set of selected product versions.

Query a paginated list of roles. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before. Only the first orderBy entry is applied.

Query a paginated list of schedule templates. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query technician availability analytics with filters for coverage area, work type, and date range.

Query a single technician team by its global ID.

Query a paginated list of technician teams. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query a paginated list of usage records. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

Query a paginated list of users. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before. Only the first orderBy entry is applied.

Query a paginated list of webhooks. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query work order custom status category analytics with filters for coverage area, work type, and date range.

Query a paginated list of work order custom statuses.

Query work order status analytics with filters for coverage area, work type, and date range.

Query work order counts grouped by custom status category.

Query a paginated list of workflow executions. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Query a paginated list of workflow secrets. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

Query a paginated list of workflow variables. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

Query a paginated list of workflows. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

Functions

account(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec account(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query an account by unique ID.

GraphQL: query { account }

Arguments

  • idGlobalID! — The account's unique ID.

account_by_readable_id(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec account_by_readable_id(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query an account by its readable ID.

GraphQL: query { accountByReadableId }

Arguments

  • readableIdInt! — The account's readable ID.

account_custom_field_definitions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec account_custom_field_definitions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of account custom field definitions.

GraphQL: query { accountCustomFieldDefinitions }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.

account_labels(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec account_labels(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of account labels.

GraphQL: query { accountLabels }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[AccountLabelOrderBy!] — Orders the results by the given fields.
  • filterAccountLabelFilter — Filters the results.

account_statuses(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec account_statuses(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of account statuses.

GraphQL: query { accountStatuses }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterAccountStatusFilter — Filters the results.

account_types(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec account_types(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of account types.

GraphQL: query { accountTypes }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.

accounts(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec accounts(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of accounts.

GraphQL: query { accounts }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[AccountOrderBy!] — Orders the results by the given fields.
  • filterAccountFilter — Filters the results.

accounts_in_network_sites(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec accounts_in_network_sites(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query accounts in network sites by traversing device hierarchy.

GraphQL: query { accountsInNetworkSites }

Arguments

  • filtersAccountsInNetworkSitesQueryFilters! — Filters to apply to the query.
  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.

address_custom_field_definitions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec address_custom_field_definitions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of address custom field definitions.

GraphQL: query { addressCustomFieldDefinitions }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersAddressCustomFieldDefinitionFilters — Filters to apply to the query.

addresses(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec addresses(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of addresses.

GraphQL: query { addresses }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterAddressesQueryFilter — Filters to apply to the query.
  • orderBy[AddressOrderBy!] — Order by which to sort results.

appointment_settings(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec appointment_settings(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Retrieve the tenant's appointment settings, with arrival windows resolved for an optional work type.

GraphQL: query { appointmentSettings }

Arguments

  • workTypeIdGlobalID — The work type whose custom arrival windows should be used. When omitted, or when the work type has no custom set, the tenant's default arrival windows are returned.

archived_bundles(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec archived_bundles(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of archived product bundles.

GraphQL: query { archivedBundles }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersBundlesQueryFilters — Filters to apply to the query.

archived_coverage_areas(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec archived_coverage_areas(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of archived coverage areas.

GraphQL: query { archivedCoverageAreas }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterArchivedCoverageAreasQueryFilter — Filters to apply to the query.

archived_inventory_roles(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec archived_inventory_roles(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query to get a list of archived inventory roles.

GraphQL: query { archivedInventoryRoles }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersArchivedInventoryRolesQueryFilters — Filters to apply to the query

availabilities_for_auto_assign(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec availabilities_for_auto_assign(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query availabilities for auto-assignment with travel time constraints.

GraphQL: query { availabilitiesForAutoAssign }

Arguments

  • inputAvailabilitiesForAutoAssignInput! — The input required to query availabilities for auto-assignment.

available_days_by_work_order_id(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec available_days_by_work_order_id(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query the available days for a work order.

GraphQL: query { availableDaysByWorkOrderId }

Arguments

  • inputAvailableDaysByWorkOrderIdQueryInput! — The input required to query the available days for a work order.

available_start_times_by_work_order_id(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec available_start_times_by_work_order_id(
  Gaiia.Client.t(),
  map(),
  String.t(),
  keyword()
) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query the available start times for a work order.

GraphQL: query { availableStartTimesByWorkOrderId }

Arguments

  • inputAvailableStartTimesByWorkOrderIdQueryInput! — The input required to query the available start times for a work order.

available_technicians_for_work_order_and_start_date(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec available_technicians_for_work_order_and_start_date(
  Gaiia.Client.t(),
  map(),
  String.t(),
  keyword()
) :: {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of technicians available for a work order on a specified date.

GraphQL: query { availableTechniciansForWorkOrderAndStartDate }

Arguments

  • firstInt — Return up to the first n technicians from the list.
  • lastInt — Returns up to the last n technicians from the list.
  • afterString — Returns the technicians that come after the specified cursor.
  • beforeString — Returns the technicians that come before the specified cursor.
  • orderBy[TechnicianOrderBy!] — Orders the results by the given fields.
  • filterTechnicianFilter — Filters the results.
  • startDateDateTime! — The start date of the work order to search for technicians.
  • workOrderIdGlobalID! — The work order's ID.

billing_subscription(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec billing_subscription(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a billing subscription by unique ID.

GraphQL: query { billingSubscription }

Arguments

  • idGlobalID! — The billing subscription's unique ID.

billing_subscriptions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec billing_subscriptions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of billing subscriptions. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

GraphQL: query { billingSubscriptions }

Arguments

  • beforeString — Returns the elements that come before the specified cursor.
  • afterString — Returns the elements that come after the specified cursor.
  • firstInt — Returns up to the first 'n' elements from the list.
  • lastInt — Returns up to the last 'n' elements from the list.
  • filterBillingSubscriptionsFilter — Filters the results.
  • orderBy[BillingSubscriptionsOrderBy!] — Orders the results by the given fields.

bundle(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec bundle(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Get a bundle by its ID.

GraphQL: query { bundle }

Arguments

  • idGlobalID! — The bundle's unique ID.

bundles(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec bundles(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of product bundles.

GraphQL: query { bundles }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersBundlesQueryFilters — Filters to apply to the query.

cancellation_reasons(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec cancellation_reasons(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of cancellation reasons.

GraphQL: query { cancellationReasons }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterCancellationReasonFilter — Filter the cancellation reasons by category.

commercial_account_statuses(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec commercial_account_statuses(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of commercial account statuses.

GraphQL: query { commercialAccountStatuses }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterCommercialAccountStatusFilter — Filters the results.

commercial_accounts(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec commercial_accounts(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of commercial accounts. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { commercialAccounts }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[CommercialAccountOrderBy!] — Orders the results by the given fields.
  • filterCommercialAccountsFilter — Filters the results.

communication_type_groups(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec communication_type_groups(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query the full list of Communication Type Groups, ordered for display.

Note: intentionally returns a flat list rather than a Connection because this is a small, bounded, static global list that is always returned in full and never paginated.

GraphQL: query { communicationTypeGroups }

Takes no arguments.

coverage_areas(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec coverage_areas(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of coverage areas.

GraphQL: query { coverageAreas }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterCoverageAreasQueryFilter — Filters to apply to the query.

custom_object_definitions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec custom_object_definitions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

List all custom object definitions for the tenant. The arguments first and last are mutually exclusive; only one can be set at a time. The same applies to after and before.

GraphQL: query { customObjectDefinitions }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersCustomObjectDefinitionsFilters — Filters to apply.

custom_object_field(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec custom_object_field(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Fetch a single custom object field definition by id.

GraphQL: query { customObjectField }

Arguments

  • idGlobalID! — The field definition's unique identifier.

custom_object_fields(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec custom_object_fields(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

List all field definitions for a custom object. The arguments first and last are mutually exclusive; only one can be set at a time. The same applies to after and before.

GraphQL: query { customObjectFields }

Arguments

  • objectDefinitionIdGlobalID! — The object definition's unique identifier.
  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersCustomObjectFieldsFilters — Filters to apply.

custom_object_record(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec custom_object_record(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Fetch a single custom object record by id.

GraphQL: query { customObjectRecord }

Arguments

  • idGlobalID! — The record's unique identifier.

custom_object_records(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec custom_object_records(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

List records for a custom object type. The arguments first and last are mutually exclusive; only one can be set at a time. The same applies to after and before.

GraphQL: query { customObjectRecords }

Arguments

  • objectDefinitionIdGlobalID! — The object definition's unique identifier.
  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersCustomObjectRecordsFilters — Filters to apply.

custom_object_records_by_ids(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec custom_object_records_by_ids(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Fetch multiple custom object records by their ids.

GraphQL: query { customObjectRecordsByIds }

Arguments

  • ids[GlobalID!]! — The record unique identifiers.

customer_owned_items(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec customer_owned_items(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of customer owned items.

GraphQL: query { customerOwnedItems }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersCustomerOwnedItemsQueryFilters — Filters to apply to the query.

default_appointment_config(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec default_appointment_config(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Retrieve the default appointment configuration.

GraphQL: query { defaultAppointmentConfig }

Takes no arguments.

entity_custom_field_definitions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec entity_custom_field_definitions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Get entity custom field definitions for a specific entity type.

GraphQL: query { entityCustomFieldDefinitions }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterEntityCustomFieldDefinitionFilter — Filters available for the query.

feature_flags(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec feature_flags(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query feature flags from AppConfig

GraphQL: query { featureFlags }

Takes no arguments.

find_address(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec find_address(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Find an address.

GraphQL: query { findAddress }

Arguments

  • inputFindAddressInput! — The input required to find an address.

incident(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec incident(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query an incident by unique ID.

GraphQL: query { incident }

Arguments

  • idGlobalID! — The incident's unique ID.

incident_procedure_template(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec incident_procedure_template(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query an incident procedure template.

GraphQL: query { incidentProcedureTemplate }

Arguments

  • idGlobalID! — The incident procedure template's unique ID.

incident_procedure_templates(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec incident_procedure_templates(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of incident procedure templates.

GraphQL: query { incidentProcedureTemplates }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.

incidents(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec incidents(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of incidents.

GraphQL: query { incidents }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersIncidentFilter — Filters the results.

integration_none(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec integration_none(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

GraphQL query integrationNone.

GraphQL: query { integrationNone }

Takes no arguments.

inventory_item(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec inventory_item(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a single inventory item by its ID.

GraphQL: query { inventoryItem }

Arguments

  • idGlobalID! — The global ID of the inventory item to retrieve.

inventory_items(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec inventory_items(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of inventory items.

GraphQL: query { inventoryItems }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersInventoryItemsQueryFilters — Filters to apply to the query.

inventory_locations(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec inventory_locations(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query to get a list of inventory locations.

GraphQL: query { inventoryLocations }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersInventoryLocationsQueryFilters — Filters to apply to the query.

inventory_model_categories(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec inventory_model_categories(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query to get all inventory model categories.

GraphQL: query { inventoryModelCategories }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • beforeString — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • lastInt — Returns the elements that come before the specified cursor.

inventory_models(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec inventory_models(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query to get a list of inventory models.

GraphQL: query { inventoryModels }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersInventoryModelQueryFilters — Filters to apply to the query.

inventory_roles(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec inventory_roles(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query to get a list of inventory roles.

GraphQL: query { inventoryRoles }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersInventoryRolesQueryFilters — Filters to apply to the query

invoice(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec invoice(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query an invoice by unique ID.

GraphQL: query { invoice }

Arguments

  • idGlobalID! — The invoice's unique Id.

invoices(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec invoices(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of billing invoices. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

GraphQL: query { invoices }

Arguments

  • beforeString — Returns the elements that come before the specified cursor.
  • firstInt — Returns up to the first 'n' elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • lastInt — Returns up to the last 'n' elements from the list.
  • filterInvoicesFilter — Filters the results.

manufacturers(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec manufacturers(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query to get a list of manufacturers.

GraphQL: query { manufacturers }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersManufacturersQueryFilters — Filters to apply to the query

network_site(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec network_site(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a network site by unique ID.

GraphQL: query { networkSite }

Arguments

  • idGlobalID! — The network site's unique ID.

network_sites(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec network_sites(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query to get a list of network sites.

GraphQL: query { networkSites }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filtersNetworkSiteFilters — Filters to apply to the query.
  • orderBy[NetworkSiteOrderBy!] — Orders the results by the given fields.

note(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec note(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a note by unique ID.

GraphQL: query { note }

Arguments

  • idGlobalID! — The notes's unique ID.

notes(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec notes(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of notes.

GraphQL: query { notes }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterNoteFilter — Filters the results.

notifications(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec notifications(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Get a paginated list of notifications. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { notifications }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterNotificationsFilter — Filters the results.
  • orderBy[NotificationOrderBy!] — Ordering of the results.

order(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec order(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query an order by unique ID.

GraphQL: query { order }

Arguments

  • idGlobalID! — The order's unique ID.

order_attribution_profile(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec order_attribution_profile(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query an order attribution profile by unique ID.

GraphQL: query { orderAttributionProfile }

Arguments

  • idGlobalID! — The order attribution profile's unique ID.

order_attribution_profiles(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec order_attribution_profiles(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of order attribution profiles. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { orderAttributionProfiles }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • searchTermString — Search by profile name.
  • filterOrderAttributionProfileFilter — Filters the results.

orders(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec orders(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of orders. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { orders }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterOrderFilter — Filters the results.
  • orderBy[OrderOrderBy!] — Orders the results by the given fields.

payment_methods(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec payment_methods(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of payment methods. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

GraphQL: query { paymentMethods }

Arguments

  • beforeString — Returns the elements that come before the specified cursor.
  • firstInt — Returns up to the first 'n' elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • lastInt — Returns up to the last 'n' elements from the list.
  • filterPaymentMethodsFilter — Filters the results.

pin_verification(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec pin_verification(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query the PIN verification status for an entity.

GraphQL: query { pinVerification }

Arguments

  • entityIdGlobalID! — The entity to check verification status for.

planned_service_area(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec planned_service_area(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a plan service area by unique ID.

GraphQL: query { plannedServiceArea }

Arguments

  • idGlobalID! — The plan service area's unique ID.

planned_service_area_by_slug(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec planned_service_area_by_slug(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a planned service area by unique slug.

GraphQL: query { plannedServiceAreaBySlug }

Arguments

  • slugString! — The planned service area's unique slug.

platform_service_health_check(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec platform_service_health_check(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Health check endpoint for platform service

GraphQL: query { platformServiceHealthCheck }

Takes no arguments.

platform_service_none(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec platform_service_none(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

GraphQL query platformServiceNone.

GraphQL: query { platformServiceNone }

Takes no arguments.

preview_schedule_for_schedule_template_id(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec preview_schedule_for_schedule_template_id(
  Gaiia.Client.t(),
  map(),
  String.t(),
  keyword()
) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Preview the schedule events that would be generated from an existing schedule template.

GraphQL: query { previewScheduleForScheduleTemplateId }

Arguments

  • inputPreviewScheduleForScheduleTemplateIdInput! — The previewScheduleForScheduleTemplateId query's input.

product_availability_job(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec product_availability_job(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Retrieve a product availability job by its ID. Requires a gaiia publishable key in the request headers.

GraphQL: query { productAvailabilityJob }

Arguments

  • idGlobalID! — ID of the product availability job to retrieve.

product_by_slug(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec product_by_slug(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Get a product by slug. If the slug is not current, attempts to resolve it using product slug history.

GraphQL: query { productBySlug }

Arguments

  • slugString! — The product slug from the URL.

product_categories(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec product_categories(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of product categories.

GraphQL: query { productCategories }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.

product_version(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec product_version(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Get a productVersion by its ID.

GraphQL: query { productVersion }

Arguments

  • idGlobalID! — The productVersion's unique ID.

product_versions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec product_versions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of product versions.

GraphQL: query { productVersions }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterProductVersionFilter — Filter the results.

products(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec products(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of products.

GraphQL: query { products }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterProductFilter — Filter the results.

properties(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec properties(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a list of properties.

GraphQL: query { properties }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[PropertyOrderBy!] — Orders the results by the given fields.
  • filterPropertyFilter — Filters the results.

property(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec property(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a property by unique ID.

GraphQL: query { property }

Arguments

  • idGlobalID! — The property's unique ID.

property_group(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec property_group(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a property group by unique ID.

GraphQL: query { propertyGroup }

Arguments

  • idGlobalID! — The property group's unique ID.

property_groups(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec property_groups(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of property groups.

GraphQL: query { propertyGroups }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[PropertyGroupOrderBy!] — Orders the results by the given fields.
  • filterPropertyGroupFilter — Filters the results.

resolve_product_eligibility(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec resolve_product_eligibility(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Evaluates product version and bundle eligibility against a set of selected product versions.

GraphQL: query { resolveProductEligibility }

Arguments

  • availableProductVersionIds[GlobalID!]! — The IDs of the product versions that are available at the address.
  • availableBundleIds[GlobalID!]! — The IDs of the bundles that are available at the address.
  • selectedProductVersionIds[GlobalID!]! — The IDs of the product versions the customer currently has selected.

role(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec role(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a role by unique ID.

GraphQL: query { role }

Arguments

  • idGlobalID! — The role's unique ID.

roles(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec roles(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of roles. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before. Only the first orderBy entry is applied.

GraphQL: query { roles }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterRoleFilter — Filters the results.
  • orderBy[RoleOrderBy!] — Orders the results by the given field. Only the first entry is applied.

schedule_template(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec schedule_template(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a schedule template by unique ID.

GraphQL: query { scheduleTemplate }

Arguments

  • idGlobalID! — The schedule template's unique ID.

schedule_templates(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec schedule_templates(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of schedule templates. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { scheduleTemplates }

Arguments

  • firstInt — Return up to the first n schedule templates from the list.
  • lastInt — Returns up to the last n schedule templates from the list.
  • afterString — Returns the schedule templates that come after the specified cursor.
  • beforeString — Returns the schedule templates that come before the specified cursor.
  • orderBy[WorkforceScheduleTemplateOrderBy!] — Orders the results by the given fields.
  • filterWorkforceScheduleTemplateFilter — Filters the results.

search_entities(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec search_entities(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Search entities by a query string.

GraphQL: query { searchEntities }

Arguments

  • queryString! — The search query string.
  • entityTypes[SearchEntityType!] — The types of entities to search for. If not provided, all types are searched.
  • limitInt — The maximum number of results to return.

tag_definitions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec tag_definitions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of tag definitions.

GraphQL: query { tagDefinitions }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterTagDefinitionsFilter — Filters the results.

technician_availability_analytics(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec technician_availability_analytics(
  Gaiia.Client.t(),
  map(),
  String.t(),
  keyword()
) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query technician availability analytics with filters for coverage area, work type, and date range.

GraphQL: query { technicianAvailabilityAnalytics }

Arguments

  • inputTechnicianAvailabilityAnalyticsInput! — Input filters for the analytics query.

technician_team_by_id(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec technician_team_by_id(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a single technician team by its global ID.

GraphQL: query { technicianTeamById }

Arguments

  • idGlobalID! — The technician team's global ID.

technician_teams(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec technician_teams(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of technician teams. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { technicianTeams }

Arguments

  • firstInt — Return up to the first n technician teams from the list.
  • lastInt — Returns up to the last n technician teams from the list.
  • afterString — Returns the technician teams that come after the specified cursor.
  • beforeString — Returns the technician teams that come before the specified cursor.
  • orderBy[TechnicianTeamOrderBy!] — Orders the results by the given fields.
  • filterTechnicianTeamFilter — Filters the results.

technicians(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec technicians(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of technicians.

GraphQL: query { technicians }

Arguments

  • firstInt — Return up to the first n technicians from the list.
  • lastInt — Returns up to the last n technicians from the list.
  • afterString — Returns the technicians that come after the specified cursor.
  • beforeString — Returns the technicians that come before the specified cursor.
  • orderBy[TechnicianOrderBy!] — Orders the results by the given fields.
  • filterTechnicianFilter — Filters the results.

ticket(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a ticket by unique ID.

GraphQL: query { ticket }

Arguments

  • idGlobalID! — The ticket's unique ID.

ticket_by_readable_id(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket_by_readable_id(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a ticket by its readable ID.

GraphQL: query { ticketByReadableId }

Arguments

  • readableIdInt! — The ticket's readable ID.

ticket_categories(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket_categories(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of ticket categories.

GraphQL: query { ticketCategories }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[TicketCategoryOrderBy!] — Orders the results by the given fields.
  • filterTicketCategoryFilter — Filters the results.

ticket_closed_reasons(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket_closed_reasons(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of ticket closed reasons.

GraphQL: query { ticketClosedReasons }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[TicketClosedReasonOrderBy!] — Orders the results by the given fields.
  • filterTicketClosedReasonFilter — Filters the results.

ticket_custom_statuses(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket_custom_statuses(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of ticket custom statuses.

GraphQL: query { ticketCustomStatuses }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[TicketCustomStatusOrderBy!] — Orders the results by the given fields.
  • filterTicketCustomStatusFilter — Filters the results.

ticket_mailboxes(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket_mailboxes(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of ticket mailboxes.

GraphQL: query { ticketMailboxes }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.

ticket_templates(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket_templates(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of ticket templates.

GraphQL: query { ticketTemplates }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[TicketTemplateOrderBy!] — Orders the results by the given fields.
  • filterTicketTemplateFilter — Filters the results.

ticket_types(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec ticket_types(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of ticket types.

GraphQL: query { ticketTypes }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[TicketTypeOrderBy!] — Orders the results by the given fields.
  • filterTicketTypeFilter — Filters the results.

tickets(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec tickets(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query paginated list of tickets.

GraphQL: query { tickets }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[TicketOrderBy!] — Orders the results by the given fields.
  • filterTicketFilter — Filters the results.

time_blocker(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec time_blocker(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a time blocker by unique ID.

GraphQL: query { timeBlocker }

Arguments

  • idGlobalID! — The time blocker's unique ID.

time_blocker_by_readable_id(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec time_blocker_by_readable_id(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a time blocker by readable ID.

GraphQL: query { timeBlockerByReadableId }

Arguments

  • readableIdInt! — The time blocker's readable ID.

time_blockers(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec time_blockers(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of time blockers.

GraphQL: query { timeBlockers }

Arguments

  • firstInt — Return up to the first n time blockers from the list.
  • lastInt — Returns up to the last n time blockers from the list.
  • afterString — Returns the time blockers that come after the specified cursor.
  • beforeString — Returns the time blockers that come before the specified cursor.
  • filterTimeBlockerFilter — Filters the results.

transaction(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec transaction(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a transaction by unique ID.

GraphQL: query { transaction }

Arguments

  • idGlobalID! — The transaction's unique ID.

unit(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec unit(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a unit by unique id.

GraphQL: query { unit }

Arguments

  • idGlobalID! — The unit's unique ID.

units(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec units(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a list of units.

GraphQL: query { units }

Arguments

  • firstInt — Returns the first n elements from the list.
  • lastInt — Returns the last n elements from the list.
  • beforeString — Returns the elements that come after the specified cursor.
  • afterString — Returns the elements that come before the specified cursor.
  • orderBy[UnitOrderBy!] — Orders the results by the given fields.
  • filterUnitFilter — Filters the results.

usage_records(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec usage_records(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of usage records. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

GraphQL: query { usageRecords }

Arguments

  • beforeString — Returns the elements that come before the specified cursor.
  • firstInt — Returns up to the first 'n' elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • lastInt — Returns up to the last 'n' elements from the list.
  • filterUsageRecordsFilter — Filters the results.

user(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec user(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a user by unique ID.

GraphQL: query { user }

Arguments

  • idGlobalID! — The user's unique ID.

users(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec users(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of users. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before. Only the first orderBy entry is applied.

GraphQL: query { users }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterUserFilter — Filters the results.
  • orderBy[UserOrderBy!] — Orders the results by the given field. Only the first entry is applied.

webhook(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec webhook(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a webhook by unique ID.

GraphQL: query { webhook }

Arguments

  • idGlobalID! — The webhook's unique ID.

webhook_execution(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec webhook_execution(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a webhook execution by unique ID.

GraphQL: query { webhookExecution }

Arguments

  • idGlobalID! — The webhook execution's unique ID.

webhooks(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec webhooks(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of webhooks. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { webhooks }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[WebhookOrderBy!] — Orders the results by the given fields.
  • filterWebhookFilter — Filters the results.

work_order_custom_status_category_analytics(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec work_order_custom_status_category_analytics(
  Gaiia.Client.t(),
  map(),
  String.t(),
  keyword()
) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query work order custom status category analytics with filters for coverage area, work type, and date range.

GraphQL: query { workOrderCustomStatusCategoryAnalytics }

Arguments

  • inputWorkOrderCustomStatusCategoryAnalyticsInput! — Input filters for the analytics query.

work_order_custom_statuses(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec work_order_custom_statuses(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of work order custom statuses.

GraphQL: query { workOrderCustomStatuses }

Arguments

  • firstInt — Return up to the first n work order custom statuses from the list.
  • lastInt — Returns up to the last n work order custom statuses from the list.
  • afterString — Returns the work order custom statuses that come after the specified cursor.
  • beforeString — Returns the work order custom statuses that come before the specified cursor.
  • orderBy[WorkOrderCustomStatusOrderBy!] — Orders the results by the given fields.
  • filterWorkOrderCustomStatusFilter — Filters the results.

work_order_status_analytics(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec work_order_status_analytics(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query work order status analytics with filters for coverage area, work type, and date range.

GraphQL: query { workOrderStatusAnalytics }

Arguments

  • inputWorkOrderStatusAnalyticsInput! — Input filters for the analytics query.

work_order_status_counts_by_category(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec work_order_status_counts_by_category(
  Gaiia.Client.t(),
  map(),
  String.t(),
  keyword()
) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query work order counts grouped by custom status category.

GraphQL: query { workOrderStatusCountsByCategory }

Takes no arguments.

work_orders(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec work_orders(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of work orders.

GraphQL: query { workOrders }

Arguments

  • firstInt — Return up to the first n work orders from the list.
  • lastInt — Returns up to the last n work orders from the list.
  • afterString — Returns the work orders that come after the specified cursor.
  • beforeString — Returns the work orders that come before the specified cursor.
  • orderBy[WorkOrderOrderBy!] — Orders the results by the given fields.
  • filterWorkOrderFilter — Filters the results.

work_types(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec work_types(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of work types.

GraphQL: query { workTypes }

Arguments

  • firstInt — Return up to the first n work types from the list.
  • lastInt — Returns up to the last n work types from the list.
  • afterString — Returns the work types that come after the specified cursor.
  • beforeString — Returns the work types that come before the specified cursor.
  • orderBy[WorkTypeOrderBy!] — Orders the results by the given fields.
  • filterWorkTypeFilter — Filters the results.

workflow_definition(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflow_definition(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a workflow definition by unique ID.

GraphQL: query { workflowDefinition }

Arguments

  • idGlobalID! — The workflow definition's unique ID.

workflow_execution(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflow_execution(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a workflow execution by unique ID.

GraphQL: query { workflowExecution }

Arguments

  • idGlobalID! — The workflow execution's unique ID.

workflow_executions(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflow_executions(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of workflow executions. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { workflowExecutions }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • filterWorkflowExecutionFilter — Filters the results.
  • orderBy[WorkflowExecutionOrderBy!] — Orders the results by the given fields.

workflow_node_execution(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflow_node_execution(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a workflow node execution by unique ID.

GraphQL: query { workflowNodeExecution }

Arguments

  • idGlobalID! — The workflow node execution's unique ID.

workflow_node_execution_result(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflow_node_execution_result(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a workflow node execution result by unique ID.

GraphQL: query { workflowNodeExecutionResult }

Arguments

  • idGlobalID! — The workflow node execution result's unique ID.

workflow_secrets(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflow_secrets(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of workflow secrets. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

GraphQL: query { workflowSecrets }

Arguments

  • firstInt — Returns up to the first 'n' elements from the list.
  • lastInt — Returns up to the last 'n' elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[WorkflowSecretOrderBy!] — Orders the results by the given fields.
  • filterWorkflowSecretFilter — Filters the results.

workflow_variables(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflow_variables(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of workflow variables. The arguments 'first' and 'last' are mutually exclusive; only one of them can be set at a time. The same applies to 'after' and 'before'.

GraphQL: query { workflowVariables }

Arguments

  • firstInt — Returns up to the first 'n' elements from the list.
  • lastInt — Returns up to the last 'n' elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[WorkflowVariableOrderBy!] — Orders the results by the given fields.
  • filterWorkflowVariableFilter — Filters the results.

workflows(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workflows(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query a paginated list of workflows. The arguments first and last are mutually exclusive; only one of them can be set at a time. The same applies to after and before.

GraphQL: query { workflows }

Arguments

  • firstInt — Returns up to the first n elements from the list.
  • lastInt — Returns up to the last n elements from the list.
  • afterString — Returns the elements that come after the specified cursor.
  • beforeString — Returns the elements that come before the specified cursor.
  • orderBy[WorkflowOrderBy!] — Orders the results by the given fields.
  • filterWorkflowFilter — Filters the results.

workforce_overview_statistics(client, variables \\ %{}, selection \\ "", opts \\ [])

@spec workforce_overview_statistics(Gaiia.Client.t(), map(), String.t(), keyword()) ::
  {:ok, term()} | {:error, Gaiia.Error.t()}

Query workforce overview statistics.

GraphQL: query { workforceOverviewStatistics }

Takes no arguments.