Secure Service Hub GraphQL API Reference

Welcome to the Secure Service Hub GraphQL API Reference! This documentation provides detailed information about the GraphQL API endpoints, queries, mutations, and types available in our Secure Service Hub platform.

Contact

Support

https://symmedia.atlassian.net/servicedesk/customer/portals

API Endpoints

# non-productive environments:
https://api-{environment}.secure-service-hub.com/
# Production server:
https://api.secure-service-hub.com/

Headers

# Your Auth token
Authorization: Bearer <YOUR_TOKEN_HERE>
# Your API key
api-key: s3cretAP1k3y

Overview

The Secure Service Hub GraphQL API empowers developers to interact with our services programmatically. With this API, you can perform various operations related to customers, machines, service cases, and more.

Getting Started

To get started with the Secure Service Hub GraphQL API, you will need API credentials and an understanding of GraphQL queries and mutations. Please refer to the Authentication section for details on obtaining API access tokens.

Documentation Structure

This documentation is organized as follows:

Queries: Describes read-only operations and how to retrieve information from the API.
Mutations: Covers write operations and how to make changes to the system.
Types: Lists the data types used in the API.

Example Usage

Here's a simple example of how to use the Secure Service Hub GraphQL API to retrieve your user information:

query {
  myUser {
    id
    username
    email
  }
}

Authentication

All Secure Service Hub API queries and mutations require dual authentication using a valid API Key and a valid Bearer Token. You need to include both in the HTTP headers of your requests.

Example Request Headers

POST /graphql HTTP/1.1
Host: api.secureservicehub.com
api-key: <Your API Key>
Authorization: Bearer <Your Bearer Token>
Content-Type: application/json

In the example above:

<Your API Key> should be replaced with your valid API Key.
<Your Bearer Token> should be replaced with your valid Bearer Token. Please ensure that you include both the API Key (api-key) and Bearer Token (Authorization) in the headers of your GraphQL requests to properly authenticate and access the Secure Service Hub API.

How to Obtain an API Key from Symmedia ?

To obtain an API key from Symmedia, follow these steps:

Contact Symmedia: Reach out to Symmedia through their official website, support email, or support hotline to request an API key.
Submit Your Request: Explain your purpose or the type of integration you plan to undertake with the API key. This helps Symmedia provide you with the appropriate key and instructions.
Receive Documentation and Instructions: Symmedia will likely provide specific instructions on how to use the API key for authentication. Ensure that you carefully read and follow these instructions.
Prioritize Security: Treat the API key with care and store it securely, as it grants access to systems and data. Adhere to best security practices to protect your API key.
Integrate: Once you have the API key and have followed the provided instructions, you can proceed with integrating it into your systems and utilize the Symmedia API as needed.

How to Obtain an Bearertoken (Development)

To obtain a Bearertoken, follow these steps:

Login to the Secure Service Hub: Got to the Portal and login with your credentials.
Open the Developer Tools: Open the developer tools of your browser and go to the network tab.
Search for a GraphQL Request: Search for the GraphQL request in the network tab. The request should look like this: graphql?myTenantUser
Copy the Bearertoken: Copy the Bearertoken from the request and use it in the Header for the Api Request.

Queries

`assetsPaginated`

Response

Returns an AssetQueryResult!

Example

Query

query AssetsPaginated {
  assetsPaginated {
    data {
      id
      edgeDevice {
        id
        iotDeviceId
      }
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      serialNumber
      displayName
      avatar
      machineModel {
        id
        modelName
        technology
        brand
        externalId
      }
      facility {
        id
        tenant {
          ...TenantFragment
        }
        name
        description
      }
      dataSourceConfigs {
        id
        tenantId
        name
        adapterType
        payload {
          ...DataSourceConfigPayloadFragment
        }
      }
    }
  }
}

Response

{"data": {"assetsPaginated": {"data": [Asset]}}}

Queries

`customer`

Response

Returns a Customer

Arguments

Name	Description
`id` - `ID`
`externalId` - `String`

Example

Query

query Customer(
  $id: ID,
  $externalId: String
) {
  customer(
    id: $id,
    externalId: $externalId
  ) {
    id
    name
    status
    externalId
    serviceOrganisation {
      id
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      name
      description
    }
    address {
      country
      state
      city
      postalCode
      street
      street2
    }
  }
}

Variables

{
  "id": "4",
  "externalId": "xyz789"
}

Response

{
  "data": {
    "customer": {
      "id": 4,
      "name": "xyz789",
      "status": "NEW",
      "externalId": "xyz789",
      "serviceOrganisation": ServiceOrganisation,
      "address": {
        "street": "Metadata example of `street`",
        "city": "Metadata example of `city`",
        "state": "Metadata example of `state`",
        "zip": "Metadata example of `zip`"
      }
    }
  }
}

Queries

`customerMachine`

Response

Returns a CustomerMachine

Arguments

Name	Description
`customerMachineId` - `ID`
`externalId` - `String`

Example

Query

query CustomerMachine(
  $customerMachineId: ID,
  $externalId: String
) {
  customerMachine(
    customerMachineId: $customerMachineId,
    externalId: $externalId
  ) {
    id
    serialNumber
    machineModel {
      id
      modelName
      technology
      brand
      externalId
    }
    displayName
    externalId
    avatar
    status
    customer {
      id
      name
      status
      externalId
      serviceOrganisation {
        id
        tenant {
          ...TenantFragment
        }
        name
        description
      }
      address {
        country
        state
        city
        postalCode
        street
        street2
      }
    }
    isSp1Migration
    edgeDeviceSerialNumber
  }
}

Variables

{
  "customerMachineId": 4,
  "externalId": "abc123"
}

Response

{
  "data": {
    "customerMachine": {
      "id": "4",
      "serialNumber": "xyz789",
      "machineModel": MachineModel,
      "displayName": "xyz789",
      "externalId": "abc123",
      "avatar": "abc123",
      "status": "NEW",
      "customer": Customer,
      "isSp1Migration": false,
      "edgeDeviceSerialNumber": "abc123"
    }
  }
}

Queries

`customerMachinesPaginated`

Response

Returns a CustomerMachineQueryResult!

Example

Query

query CustomerMachinesPaginated {
  customerMachinesPaginated {
    data {
      id
      serialNumber
      machineModel {
        id
        modelName
        technology
        brand
        externalId
      }
      displayName
      externalId
      avatar
      status
      customer {
        id
        name
        status
        externalId
        serviceOrganisation {
          ...ServiceOrganisationFragment
        }
        address {
          ...AddressFragment
        }
      }
      isSp1Migration
      edgeDeviceSerialNumber
    }
  }
}

Response

{
  "data": {
    "customerMachinesPaginated": {
      "data": [CustomerMachine]
    }
  }
}

Queries

`customersPaginated`

Response

Returns a CustomerQueryResult!

Arguments

Name	Description
`options` - `CustomerOptions`

Example

Query

query CustomersPaginated($options: CustomerOptions) {
  customersPaginated(options: $options) {
    data {
      id
      name
      status
      externalId
      serviceOrganisation {
        id
        tenant {
          ...TenantFragment
        }
        name
        description
      }
      address {
        country
        state
        city
        postalCode
        street
        street2
      }
    }
    pageInfo {
      totalElements
      totalPages
      currentPage
      fromElement
      untilElement
    }
  }
}

Variables

{"options": CustomerOptions}

Response

{
  "data": {
    "customersPaginated": {
      "data": [Customer],
      "pageInfo": PageInfo
    }
  }
}

Queries

`dataPoints`

Response

Returns a DataPointsResult

Arguments

Name	Description
`options` - `DataPointsOptions!`

Example

Query

query DataPoints($options: DataPointsOptions!) {
  dataPoints(options: $options) {
    machineDataPoints {
      assetId
      dataPoints {
        timestampUtc
        dataPointName
        value
      }
    }
  }
}

Variables

{"options": DataPointsOptions}

Response

{
  "data": {
    "dataPoints": {
      "machineDataPoints": [MachineDataPoints]
    }
  }
}

Queries

`facilitiesPaginated`

Response

Returns a FacilityQueryResult!

Example

Query

query FacilitiesPaginated {
  facilitiesPaginated {
    data {
      id
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      name
      description
    }
  }
}

Response

{"data": {"facilitiesPaginated": {"data": [Facility]}}}

Queries

`machineModel`

Response

Returns a MachineModel

Arguments

Name	Description
`machineModelId` - `ID`
`externalId` - `String`
`tenantLinkType` - `TenantLinkType`	Default = `ALL`

Example

Query

query MachineModel(
  $machineModelId: ID,
  $externalId: String,
  $tenantLinkType: TenantLinkType
) {
  machineModel(
    machineModelId: $machineModelId,
    externalId: $externalId,
    tenantLinkType: $tenantLinkType
  ) {
    id
    modelName
    technology
    brand
    externalId
  }
}

Variables

{
  "machineModelId": 4,
  "externalId": "xyz789",
  "tenantLinkType": "ALL"
}

Response

{
  "data": {
    "machineModel": {
      "id": "4",
      "modelName": "abc123",
      "technology": "xyz789",
      "brand": "xyz789",
      "externalId": "xyz789"
    }
  }
}

Queries

`machineModelsPaginated`

Response

Returns a MachineModelQueryResult!

Arguments

Name	Description
`options` - `MachineModelOptions`

Example

Query

query MachineModelsPaginated($options: MachineModelOptions) {
  machineModelsPaginated(options: $options) {
    data {
      id
      modelName
      technology
      brand
      externalId
    }
  }
}

Variables

{"options": MachineModelOptions}

Response

{
  "data": {
    "machineModelsPaginated": {"data": [MachineModel]}
  }
}

Queries

`myUser`

Response

Returns a User!

Example

Query

query MyUser {
  myUser {
    id
    name
    email
    tenant {
      id
      name
      shortname
      status
      address {
        country
        state
        city
        postalCode
        street
        street2
      }
      helpLink
    }
    identityId
    isTechnicalUser
  }
}

Response

{
  "data": {
    "myUser": {
      "id": "4",
      "name": "xyz789",
      "email": "xyz789",
      "tenant": Tenant,
      "identityId": 4,
      "isTechnicalUser": true
    }
  }
}

Queries

`permissionsOfCurrentUserPaginated`

Response

Returns a PermissionsOfCurrentUserQueryResult!

Example

Query

query PermissionsOfCurrentUserPaginated {
  permissionsOfCurrentUserPaginated {
    data {
      key
      displayName
      description
      applicationId
    }
  }
}

Response

{
  "data": {
    "permissionsOfCurrentUserPaginated": {
      "data": [Permission]
    }
  }
}

Queries

`serviceCasesPaginated`

Response

Returns a ServiceCaseQueryResult!

Arguments

Name	Description
`options` - `ServiceCaseOptions!`

Example

Query

query ServiceCasesPaginated($options: ServiceCaseOptions!) {
  serviceCasesPaginated(options: $options) {
    data {
      id
      displayId
      state {
        id
        index
        name
        isClosed
      }
      title
      description
      createdAt
      updatedAt
      closedAt
      firstTimeAssignedAt
      firstTimeInProgressAt
      creator {
        id
        name
        email
        tenant {
          ...TenantFragment
        }
        identityId
        isTechnicalUser
      }
      assignee {
        id
        name
        email
        tenant {
          ...TenantFragment
        }
        identityId
        isTechnicalUser
      }
      customerMachine {
        id
        serialNumber
        machineModel {
          ...MachineModelFragment
        }
        displayName
        externalId
        avatar
        status
        customer {
          ...CustomerFragment
        }
        isSp1Migration
        edgeDeviceSerialNumber
      }
      priority
      severity
      externalId
      customFields {
        key
        value
      }
      closingReport {
        id
        isSolved
        notes
      }
    }
  }
}

Variables

{"options": "Metadata example of `nonReqQueryArg`"}

Response

{
  "data": {
    "serviceCasesPaginated": {"data": [ServiceCase]}
  }
}

Queries

`serviceContractsPaginated`

Response

Returns a ServiceContractQueryResult!

Example

Query

query ServiceContractsPaginated {
  serviceContractsPaginated {
    data {
      id
      contractName
      shortDescription
      isAssignable
      followTheSun
      serviceContractAssignments {
        id
        serviceContract {
          ...ServiceContractFragment
        }
        customerMachine {
          ...CustomerMachineFragment
        }
        startDate
        endDate
        createdAt
        updatedAt
      }
    }
  }
}

Response

{
  "data": {
    "serviceContractsPaginated": {
      "data": [ServiceContract]
    }
  }
}

Queries

`serviceOrganisationsPaginated`

Response

Returns a ServiceOrganisationQueryResult!

Example

Query

query ServiceOrganisationsPaginated {
  serviceOrganisationsPaginated {
    data {
      id
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      name
      description
    }
  }
}

Response

{
  "data": {
    "serviceOrganisationsPaginated": {
      "data": [ServiceOrganisation]
    }
  }
}

Queries

`tenant`

Response

Returns a Tenant!

Arguments

Name	Description
`id` - `ID!`

Example

Query

query Tenant($id: ID!) {
  tenant(id: $id) {
    id
    name
    shortname
    status
    address {
      country
      state
      city
      postalCode
      street
      street2
    }
    helpLink
  }
}

Variables

{"id": 4}

Response

{
  "data": {
    "tenant": {
      "id": 4,
      "name": "xyz789",
      "shortname": "xyz789",
      "status": "INCOMPLETE",
      "address": {
        "street": "Metadata example of `street`",
        "city": "Metadata example of `city`",
        "state": "Metadata example of `state`",
        "zip": "Metadata example of `zip`"
      },
      "helpLink": "xyz789"
    }
  }
}

Queries

`tenantsPaginated`

Response

Returns a TenantQueryResult!

Arguments

Name	Description
`options` - `TenantOptions`

Example

Query

query TenantsPaginated($options: TenantOptions) {
  tenantsPaginated(options: $options) {
    data {
      id
      name
      shortname
      status
      address {
        country
        state
        city
        postalCode
        street
        street2
      }
      helpLink
    }
  }
}

Variables

{"options": TenantOptions}

Response

{"data": {"tenantsPaginated": {"data": [Tenant]}}}

Queries

`timeSeries`

Response

Returns a TimeSeriesResult

Arguments

Name	Description
`options` - `TimeSeriesOptions!`

Example

Query

query TimeSeries($options: TimeSeriesOptions!) {
  timeSeries(options: $options) {
    timestamps
    assetSeries {
      assetId
      dataPointSeries {
        dataPointName
        values {
          ...FloatWithTimestampFragment
        }
      }
    }
  }
}

Variables

{"options": TimeSeriesOptions}

Response

{
  "data": {
    "timeSeries": {
      "timestamps": [
        "2007-12-03T10:15:30Z"
      ],
      "assetSeries": [AssetTimeSeries]
    }
  }
}

Mutations

`createCustomer`

Response

Returns a Customer

Arguments

Name	Description
`customer` - `CreateCustomerInput!`

Example

Query

mutation CreateCustomer($customer: CreateCustomerInput!) {
  createCustomer(customer: $customer) {
    id
    name
    status
    externalId
    serviceOrganisation {
      id
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      name
      description
    }
    address {
      country
      state
      city
      postalCode
      street
      street2
    }
  }
}

Variables

{"customer": CreateCustomerInput}

Response

{
  "data": {
    "createCustomer": {
      "id": 4,
      "name": "abc123",
      "status": "NEW",
      "externalId": "xyz789",
      "serviceOrganisation": ServiceOrganisation,
      "address": {
        "street": "Metadata example of `street`",
        "city": "Metadata example of `city`",
        "state": "Metadata example of `state`",
        "zip": "Metadata example of `zip`"
      }
    }
  }
}

Mutations

`createCustomerMachine`

Response

Returns a CustomerMachine

Arguments

Name	Description
`customerMachine` - `CreateCustomerMachineInput!`

Example

Query

mutation CreateCustomerMachine($customerMachine: CreateCustomerMachineInput!) {
  createCustomerMachine(customerMachine: $customerMachine) {
    id
    serialNumber
    machineModel {
      id
      modelName
      technology
      brand
      externalId
    }
    displayName
    externalId
    avatar
    status
    customer {
      id
      name
      status
      externalId
      serviceOrganisation {
        id
        tenant {
          ...TenantFragment
        }
        name
        description
      }
      address {
        country
        state
        city
        postalCode
        street
        street2
      }
    }
    isSp1Migration
    edgeDeviceSerialNumber
  }
}

Variables

{"customerMachine": CreateCustomerMachineInput}

Response

{
  "data": {
    "createCustomerMachine": {
      "id": 4,
      "serialNumber": "xyz789",
      "machineModel": MachineModel,
      "displayName": "xyz789",
      "externalId": "abc123",
      "avatar": "abc123",
      "status": "NEW",
      "customer": Customer,
      "isSp1Migration": false,
      "edgeDeviceSerialNumber": "abc123"
    }
  }
}

Mutations

`createMachineModel`

Response

Returns a MachineModel

Arguments

Name	Description
`machineModel` - `CreateMachineModelInput!`

Example

Query

mutation CreateMachineModel($machineModel: CreateMachineModelInput!) {
  createMachineModel(machineModel: $machineModel) {
    id
    modelName
    technology
    brand
    externalId
  }
}

Variables

{"machineModel": CreateMachineModelInput}

Response

{
  "data": {
    "createMachineModel": {
      "id": 4,
      "modelName": "xyz789",
      "technology": "xyz789",
      "brand": "abc123",
      "externalId": "abc123"
    }
  }
}

Mutations

`updateCustomer`

Response

Returns a Customer

Arguments

Name	Description
`id` - `ID!`
`customer` - `UpdateCustomerInput!`

Example

Query

mutation UpdateCustomer(
  $id: ID!,
  $customer: UpdateCustomerInput!
) {
  updateCustomer(
    id: $id,
    customer: $customer
  ) {
    id
    name
    status
    externalId
    serviceOrganisation {
      id
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      name
      description
    }
    address {
      country
      state
      city
      postalCode
      street
      street2
    }
  }
}

Variables

{"id": 4, "customer": UpdateCustomerInput}

Response

{
  "data": {
    "updateCustomer": {
      "id": 4,
      "name": "xyz789",
      "status": "NEW",
      "externalId": "xyz789",
      "serviceOrganisation": ServiceOrganisation,
      "address": {
        "street": "Metadata example of `street`",
        "city": "Metadata example of `city`",
        "state": "Metadata example of `state`",
        "zip": "Metadata example of `zip`"
      }
    }
  }
}

Mutations

`updateCustomerByExternalId`

Response

Returns a Customer

Arguments

Name	Description
`externalId` - `ID!`
`customer` - `UpdateCustomerInput!`

Example

Query

mutation UpdateCustomerByExternalId(
  $externalId: ID!,
  $customer: UpdateCustomerInput!
) {
  updateCustomerByExternalId(
    externalId: $externalId,
    customer: $customer
  ) {
    id
    name
    status
    externalId
    serviceOrganisation {
      id
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      name
      description
    }
    address {
      country
      state
      city
      postalCode
      street
      street2
    }
  }
}

Variables

{"externalId": 4, "customer": UpdateCustomerInput}

Response

{
  "data": {
    "updateCustomerByExternalId": {
      "id": "4",
      "name": "abc123",
      "status": "NEW",
      "externalId": "abc123",
      "serviceOrganisation": ServiceOrganisation,
      "address": {
        "street": "Metadata example of `street`",
        "city": "Metadata example of `city`",
        "state": "Metadata example of `state`",
        "zip": "Metadata example of `zip`"
      }
    }
  }
}

Mutations

`updateServiceCase`

Response

Returns a ServiceCase

Arguments

Name	Description
`serviceCase` - `UpdateServiceCaseInput!`

Example

Query

mutation UpdateServiceCase($serviceCase: UpdateServiceCaseInput!) {
  updateServiceCase(serviceCase: $serviceCase) {
    id
    displayId
    state {
      id
      index
      name
      isClosed
    }
    title
    description
    createdAt
    updatedAt
    closedAt
    firstTimeAssignedAt
    firstTimeInProgressAt
    creator {
      id
      name
      email
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      identityId
      isTechnicalUser
    }
    assignee {
      id
      name
      email
      tenant {
        id
        name
        shortname
        status
        address {
          ...AddressFragment
        }
        helpLink
      }
      identityId
      isTechnicalUser
    }
    customerMachine {
      id
      serialNumber
      machineModel {
        id
        modelName
        technology
        brand
        externalId
      }
      displayName
      externalId
      avatar
      status
      customer {
        id
        name
        status
        externalId
        serviceOrganisation {
          ...ServiceOrganisationFragment
        }
        address {
          ...AddressFragment
        }
      }
      isSp1Migration
      edgeDeviceSerialNumber
    }
    priority
    severity
    externalId
    customFields {
      key
      value
    }
    closingReport {
      id
      isSolved
      notes
    }
  }
}

Variables

{"serviceCase": UpdateServiceCaseInput}

Response

{
  "data": {
    "updateServiceCase": {
      "id": "4",
      "displayId": "xyz789",
      "state": ServiceCaseState,
      "title": "abc123",
      "description": "xyz789",
      "createdAt": "2007-12-03T10:15:30Z",
      "updatedAt": "2007-12-03T10:15:30Z",
      "closedAt": "2007-12-03T10:15:30Z",
      "firstTimeAssignedAt": "2007-12-03T10:15:30Z",
      "firstTimeInProgressAt": "2007-12-03T10:15:30Z",
      "creator": User,
      "assignee": User,
      "customerMachine": CustomerMachine,
      "priority": 123,
      "severity": "MACHINE_BREAKDOWN",
      "externalId": "abc123",
      "customFields": [CustomFieldValue],
      "closingReport": ClosingReport
    }
  }
}

Types

AdapterType

Values

Enum Value	Description
`OPCUA`

Example

{}

Types

Address

Fields

Field Name	Description
`country` - `String!`
`state` - `String`
`city` - `String`
`postalCode` - `String`
`street` - `String`
`street2` - `String`

Example

{
  "street": "Metadata example of `street`",
  "city": "Metadata example of `city`",
  "state": "Metadata example of `state`",
  "zip": "Metadata example of `zip`"
}

Types

AddressFilter

Fields

Input Field	Description
`country` - `StringExpression`
`postalCode` - `StringExpression`
`city` - `StringExpression`
`street` - `StringExpression`
`street2` - `StringExpression`
`state` - `StringExpression`
`and` - `[AddressFilter!]`
`or` - `[AddressFilter!]`
`not` - `AddressFilter`

Example

{}

Types

AggregationFunction

Values

Enum Value	Description
`MIN`
`MAX`
`DELTA`
`AVG`
`COUNT`

Example

{}

Types

Asset

Fields

Field Name	Description
`id` - `ID!`
`edgeDevice` - `EdgeDevice`
`tenant` - `Tenant`
`serialNumber` - `String!`
`displayName` - `String`
`avatar` - `String`
`machineModel` - `MachineModel`
`facility` - `Facility`
`dataSourceConfigs` - `[DataSourceConfigDetails]`

Example

{
  "id": 4,
  "edgeDevice": EdgeDevice,
  "tenant": Tenant,
  "serialNumber": "xyz789",
  "displayName": "xyz789",
  "avatar": "xyz789",
  "machineModel": MachineModel,
  "facility": Facility,
  "dataSourceConfigs": [DataSourceConfigDetails]
}

Types

AssetQueryResult

Fields

Field Name	Description
`data` - `[Asset!]!`

Example

{"data": [Asset]}

Types

AssetTimeSeries

Fields

Field Name	Description
`assetId` - `ID!`
`dataPointSeries` - `[DataPointTimeSeries!]!`

Example

{
  "assetId": "4",
  "dataPointSeries": [DataPointTimeSeries]
}

Types

Boolean

Description

The 'Boolean' scalar type represents 'true' or 'false' .

Example

{}

Types

ClosingReport

Fields

Field Name	Description
`id` - `ID!`
`isSolved` - `Boolean!`
`notes` - `String`

Example

{
  "id": "4",
  "isSolved": false,
  "notes": "abc123"
}

Types

CreateCustomerAddressInput

Fields

Input Field	Description
`country` - `String!`
`postalCode` - `String`
`city` - `String`
`street` - `String`
`street2` - `String`
`state` - `String`

Example

{}

Types

CreateCustomerInput

Fields

Input Field	Description
`name` - `String!`
`externalId` - `String`
`serviceOrganisation` - `ID!`
`address` - `CreateCustomerAddressInput!`

Example

{}

Types

CreateCustomerMachineInput

Fields

Input Field	Description
`customer` - `CustomerInput!`
`serialNumber` - `String!`
`machineModel` - `MachineModelInput!`
`externalId` - `String`
`edgeDeviceSerialNumber` - `String`
`isSp1Migration` - `Boolean`

Example

{}

Types

CreateMachineModelInput

Fields

Input Field	Description
`modelName` - `String!`
`technology` - `String!`
`brand` - `String`
`externalId` - `String`

Example

{}

Types

CustomFieldValue

Fields

Field Name	Description
`key` - `String!`
`value` - `String`

Example

{
  "key": "abc123",
  "value": "xyz789"
}

Types

Customer

Fields

Field Name	Description
`id` - `ID!`
`name` - `String!`
`status` - `CustomerStatus!`
`externalId` - `String`
`serviceOrganisation` - `ServiceOrganisation`
`address` - `Address`

Example

{
  "id": "4",
  "name": "abc123",
  "status": "NEW",
  "externalId": "xyz789",
  "serviceOrganisation": ServiceOrganisation,
  "address": {
    "street": "Metadata example of `street`",
    "city": "Metadata example of `city`",
    "state": "Metadata example of `state`",
    "zip": "Metadata example of `zip`"
  }
}

Types

CustomerFilter

Fields

Input Field	Description
`id` - `IDExpression`
`name` - `StringExpression`
`status` - `CustomerStatusExpression`
`linkedTenantId` - `StringExpression`
`externalId` - `StringExpression`
`websiteUrl` - `StringExpression`
`address` - `AddressFilter`
`and` - `[CustomerFilter!]`
`or` - `[CustomerFilter!]`
`not` - `CustomerFilter`

Example

{}

Types

CustomerInput

Fields

Input Field	Description
`customerId` - `ID`
`customerExternalId` - `String`

Example

{}

Types

CustomerMachine

Fields

Field Name	Description
`id` - `ID!`
`serialNumber` - `String!`
`machineModel` - `MachineModel`
`displayName` - `String`
`externalId` - `String`
`avatar` - `String`
`status` - `CustomerMachineStatus`
`customer` - `Customer`
`isSp1Migration` - `Boolean`
`edgeDeviceSerialNumber` - `String`

Example

{
  "id": 4,
  "serialNumber": "xyz789",
  "machineModel": MachineModel,
  "displayName": "abc123",
  "externalId": "xyz789",
  "avatar": "abc123",
  "status": "NEW",
  "customer": Customer,
  "isSp1Migration": true,
  "edgeDeviceSerialNumber": "xyz789"
}

Types

CustomerMachineQueryResult

Fields

Field Name	Description
`data` - `[CustomerMachine!]!`

Example

{"data": [CustomerMachine]}

Types

CustomerMachineStatus

Values

Enum Value	Description
`NEW`
`PROPOSED`
`UNCONNECTED`
`CONNECTED`

Example

{}

Types

CustomerOptions

Fields

Input Field	Description
`filter` - `CustomerFilter`
`pagination` - `PaginationInput`
`sortBy` - `[CustomerSorter!]`

Example

{}

Types

CustomerQueryResult

Fields

Field Name	Description
`data` - `[Customer]!`
`pageInfo` - `PageInfo`

Example

{
  "data": [Customer],
  "pageInfo": PageInfo
}

Types

CustomerSorter

Fields

Input Field	Description
`name` - `SortDirection`
`status` - `SortDirection`
`linkedTenantId` - `SortDirection`
`externalId` - `SortDirection`
`websiteUrl` - `SortDirection`

Example

{}

Types

CustomerStatus

Values

Enum Value	Description
`NEW`
`INVITED`
`ONBOARDED`
`DEMO`
`CONVERTED`

Example

{}

Types

CustomerStatusExpression

Fields

Input Field	Description
`is` - `CustomerStatus`

Example

{}

Types

DataPoint

Fields

Field Name	Description
`timestampUtc` - `Int!`
`dataPointName` - `String!`
`value` - `String!`

Example

{
  "timestampUtc": 987,
  "dataPointName": "xyz789",
  "value": "abc123"
}

Types

DataPointQueryRange

Values

Enum Value	Description
`IN_RANGE`
`INCLUDE_LAST_BEFORE`
`INCLUDE_FIRST_AFTER`
`INCLUDE_LAST_BEFORE_AND_FIRST_AFTER`

Example

{}

Types

DataPointSortOrder

Values

Enum Value	Description
`ASCENDING`
`DESCENDING`

Example

{}

Types

DataPointTimeSeries

Fields

Field Name	Description
`dataPointName` - `String!`
`values` - `[FloatWithTimestamp]!`

Example

{
  "dataPointName": "abc123",
  "values": [FloatWithTimestamp]
}

Types

DataPointsOptions

Fields

Input Field	Description
`assetIds` - `[ID!]!`
`timeRange` - `TimeRange!`
`dataPointNames` - `[String!]!`
`take` - `Int!`
`dataPointQueryRange` - `DataPointQueryRange!`
`sortOrder` - `DataPointSortOrder!`

Example

{}

Types

DataPointsResult

Fields

Field Name	Description
`machineDataPoints` - `[MachineDataPoints!]!`

Example

{"machineDataPoints": [MachineDataPoints]}

Types

DataSourceConfigDetails

Fields

Field Name	Description
`id` - `ID!`
`tenantId` - `ID!`
`name` - `String!`
`adapterType` - `AdapterType!`
`payload` - `[DataSourceConfigPayload]!`

Example

{
  "id": 4,
  "tenantId": 4,
  "name": "abc123",
  "adapterType": "OPCUA",
  "payload": [DataSourceConfigPayload]
}

Types

DataSourceConfigPayload

Fields

Field Name	Description
`measurementName` - `String!`
`heartbeatInterval` - `Int!`
`opcSamplingInterval` - `Int!`
`opcPublishingInterval` - `Int!`
`hotNode` - `Boolean`
`isNumeric` - `Boolean`

Example

{
  "measurementName": "xyz789",
  "heartbeatInterval": 987,
  "opcSamplingInterval": 123,
  "opcPublishingInterval": 987,
  "hotNode": false,
  "isNumeric": false
}

Types

DateTime

Example

{}

Types

Duration

Example

{}

Types

EdgeDevice

Fields

Field Name	Description
`id` - `ID!`
`iotDeviceId` - `String!`

Example

{"id": 4, "iotDeviceId": "xyz789"}

Types

Facility

Fields

Field Name	Description
`id` - `ID!`
`tenant` - `Tenant!`
`name` - `String!`
`description` - `String`

Example

{
  "id": "4",
  "tenant": Tenant,
  "name": "abc123",
  "description": "xyz789"
}

Types

FacilityQueryResult

Fields

Field Name	Description
`data` - `[Facility!]!`

Example

{"data": [Facility]}

Types

Float

Description

The 'Float' scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example

{}

Types

FloatWithTimestamp

Fields

Field Name	Description
`timestamp` - `DateTime!`
`value` - `Float`

Example

{
  "timestamp": "2007-12-03T10:15:30Z",
  "value": 987.65
}

Types

ID

Description

The 'ID' scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as '4') or integer (such as 4) input value will be accepted as an ID.

Example

{}

Types

IDExpression

Fields

Input Field	Description
`is` - `ID`

Example

{}

Types

Int

Description

The 'Int' scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example

{}

Types

MachineDataPoints

Fields

Field Name	Description
`assetId` - `ID!`
`dataPoints` - `[DataPoint!]!`

Example

{"assetId": 4, "dataPoints": [DataPoint]}

Types

MachineModel

Fields

Field Name	Description
`id` - `ID!`
`modelName` - `String!`
`technology` - `String!`
`brand` - `String`
`externalId` - `String`

Example

{
  "id": 4,
  "modelName": "xyz789",
  "technology": "abc123",
  "brand": "abc123",
  "externalId": "xyz789"
}

Types

MachineModelFilter

Fields

Input Field	Description
`tenantLinkType` - `TenantLinkType`

Example

{}

Types

MachineModelInput

Fields

Input Field	Description
`machineModelId` - `ID`
`machineModelExternalId` - `String`

Example

{}

Types

MachineModelOptions

Fields

Input Field	Description
`filter` - `MachineModelFilter`

Example

{}

Types

MachineModelQueryResult

Fields

Field Name	Description
`data` - `[MachineModel!]!`

Example

{"data": [MachineModel]}

Types

PageInfo

Fields

Field Name	Description
`totalElements` - `Int`
`totalPages` - `Int`
`currentPage` - `Int`
`fromElement` - `Int`
`untilElement` - `Int`

Example

{
  "totalElements": 987,
  "totalPages": 123,
  "currentPage": 987,
  "fromElement": 123,
  "untilElement": 123
}

Types

PaginationInput

Fields

Input Field	Description
`page` - `Int!`
`pageSize` - `Int!`

Example

{}

Types

Permission

Fields

Field Name	Description
`key` - `String!`
`displayName` - `String!`
`description` - `String!`
`applicationId` - `ID!`

Example

{
  "key": "xyz789",
  "displayName": "abc123",
  "description": "xyz789",
  "applicationId": "4"
}

Types

PermissionsOfCurrentUserQueryResult

Fields

Field Name	Description
`data` - `[Permission!]!`

Example

{"data": [Permission]}

Types

SeriesDataSource

Values

Enum Value	Description
`PRE_AGGREGATED`
`ORIGINAL`

Example

{}

Types

ServiceCase

Fields

Field Name	Description
`id` - `ID!`
`displayId` - `String!`
`state` - `ServiceCaseState`
`title` - `String!`
`description` - `String`
`createdAt` - `DateTime!`
`updatedAt` - `DateTime`
`closedAt` - `DateTime`
`firstTimeAssignedAt` - `DateTime`	The first time when the service case was assigned to a service provider user.
`firstTimeInProgressAt` - `DateTime`	The first time when the service case state was changed to IN_PROGRESS.
`creator` - `User`
`assignee` - `User`
`customerMachine` - `CustomerMachine`
`priority` - `Int`
`severity` - `Severity`
`externalId` - `String`
`customFields` - `[CustomFieldValue]`
`closingReport` - `ClosingReport`

Example

{
  "id": 4,
  "displayId": "abc123",
  "state": ServiceCaseState,
  "title": "abc123",
  "description": "abc123",
  "createdAt": "2007-12-03T10:15:30Z",
  "updatedAt": "2007-12-03T10:15:30Z",
  "closedAt": "2007-12-03T10:15:30Z",
  "firstTimeAssignedAt": "2007-12-03T10:15:30Z",
  "firstTimeInProgressAt": "2007-12-03T10:15:30Z",
  "creator": User,
  "assignee": User,
  "customerMachine": CustomerMachine,
  "priority": 987,
  "severity": "MACHINE_BREAKDOWN",
  "externalId": "xyz789",
  "customFields": [CustomFieldValue],
  "closingReport": ClosingReport
}

Types

ServiceCaseFilter

Fields

Input Field	Description
`isClosed` - `Boolean`

Example

{}

Types

ServiceCaseOptions

Fields

Input Field	Description
`view` - `ServiceCaseView!`
`filter` - `ServiceCaseFilter`

Example

{}

Types

ServiceCaseQueryResult

Fields

Field Name	Description
`data` - `[ServiceCase!]!`

Example

{"data": [ServiceCase]}

Types

ServiceCaseState

Fields

Field Name	Description
`id` - `ID!`
`index` - `Int!`
`name` - `String!`
`isClosed` - `Boolean!`

Example

{
  "id": 4,
  "index": 987,
  "name": "xyz789",
  "isClosed": false
}

Types

ServiceCaseView

Values

Enum Value	Description
`OPERATOR`
`SERVICE_PROVIDER`

Example

{}

Types

ServiceContract

Fields

Field Name	Description
`id` - `ID!`
`contractName` - `String!`
`shortDescription` - `String`
`isAssignable` - `Boolean!`
`followTheSun` - `Boolean!`
`serviceContractAssignments` - `[ServiceContractAssignment!]!`

Example

{
  "id": 4,
  "contractName": "abc123",
  "shortDescription": "xyz789",
  "isAssignable": true,
  "followTheSun": true,
  "serviceContractAssignments": [
    ServiceContractAssignment
  ]
}

Types

ServiceContractAssignment

Fields

Field Name	Description
`id` - `ID!`
`serviceContract` - `ServiceContract!`
`customerMachine` - `CustomerMachine`
`startDate` - `DateTime!`
`endDate` - `DateTime!`
`createdAt` - `DateTime!`
`updatedAt` - `DateTime`

Example

{
  "id": 4,
  "serviceContract": ServiceContract,
  "customerMachine": CustomerMachine,
  "startDate": "2007-12-03T10:15:30Z",
  "endDate": "2007-12-03T10:15:30Z",
  "createdAt": "2007-12-03T10:15:30Z",
  "updatedAt": "2007-12-03T10:15:30Z"
}

Types

ServiceContractQueryResult

Fields

Field Name	Description
`data` - `[ServiceContract!]!`

Example

{"data": [ServiceContract]}

Types

ServiceOrganisation

Fields

Field Name	Description
`id` - `ID!`
`tenant` - `Tenant!`
`name` - `String!`
`description` - `String`

Example

{
  "id": "4",
  "tenant": Tenant,
  "name": "abc123",
  "description": "abc123"
}

Types

ServiceOrganisationQueryResult

Fields

Field Name	Description
`data` - `[ServiceOrganisation!]!`

Example

{"data": [ServiceOrganisation]}

Types

Severity

Values

Enum Value	Description
`MACHINE_BREAKDOWN`
`PRODUCTION_IMPAIRED`
`NO_IMPAIRMENT`

Example

{}

Types

SortDirection

Values

Enum Value	Description
`ASC`
`DESC`

Example

{}

Types

String

Description

The 'String' scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example

{}

Types

StringExpression

Fields

Input Field	Description
`equals` - `String`
`contains` - `String`
`starts` - `String`
`ends` - `String`

Example

{}

Types

Tenant

Fields

Field Name	Description
`id` - `ID!`
`name` - `String!`
`shortname` - `String`
`status` - `TenantStatus`
`address` - `Address`
`helpLink` - `String`

Example

{
  "id": "4",
  "name": "xyz789",
  "shortname": "abc123",
  "status": "INCOMPLETE",
  "address": {
    "street": "Metadata example of `street`",
    "city": "Metadata example of `city`",
    "state": "Metadata example of `state`",
    "zip": "Metadata example of `zip`"
  },
  "helpLink": "abc123"
}

Types

TenantFilter

Fields

Input Field	Description
`status` - `[TenantStatus]`

Example

{}

Types

TenantLinkType

Values

Enum Value	Description
`ALL`
`SERVICE_PROVIDER`
`OPERATOR`
`NONE`

Example

{}

Types

TenantOptions

Fields

Input Field	Description
`filter` - `TenantFilter`

Example

{}

Types

TenantQueryResult

Fields

Field Name	Description
`data` - `[Tenant!]!`

Example

{"data": [Tenant]}

Types

TenantStatus

Values

Enum Value	Description
`INCOMPLETE`
`ACTIVE`
`DEACTIVATED`

Example

{}

Types

TimeRange

Fields

Input Field	Description
`from` - `DateTime`
`to` - `DateTime`

Example

{}

Types

TimeSeriesOptions

Fields

Input Field	Description
`assetIds` - `[ID!]!`
`timeRange` - `TimeRange!`
`dataPointNames` - `[String!]!`
`aggregation` - `AggregationFunction!`
`binSize` - `Duration!`
`dataSource` - `SeriesDataSource!`

Example

{}

Types

TimeSeriesResult

Fields

Field Name	Description
`timestamps` - `[DateTime!]!`
`assetSeries` - `[AssetTimeSeries!]!`

Example

{
  "timestamps": ["2007-12-03T10:15:30Z"],
  "assetSeries": [AssetTimeSeries]
}

Types

UpdateCustomerAddressInput

Fields

Input Field	Description
`country` - `String`
`postalCode` - `String`
`city` - `String`
`street` - `String`
`street2` - `String`
`state` - `String`

Example

{}

Types

UpdateCustomerInput

Fields

Input Field	Description
`name` - `String`
`externalId` - `String`
`websiteUrl` - `String`
`serviceOrganisation` - `ID`
`address` - `UpdateCustomerAddressInput`

Example

{}

Types

UpdateServiceCaseInput

Fields

Input Field	Description
`serviceCaseId` - `ID!`
`externalId` - `String`
`priority` - `Int`

Example

{}

Types

User

Fields

Field Name	Description
`id` - `ID!`
`name` - `String!`
`email` - `String`
`tenant` - `Tenant!`
`identityId` - `ID`
`isTechnicalUser` - `Boolean!`

Example

{
  "id": "4",
  "name": "xyz789",
  "email": "abc123",
  "tenant": Tenant,
  "identityId": 4,
  "isTechnicalUser": true
}

Documentation by Anvil SpectaQL