Mutations

In this section

About Mutations
API Site
backendScreenEvent
cancelSmartFlexOnboarding
completeAuthFlowForSmartFlexOnboarding
completeTeslaSetupVirtualKeyForSmartFlexOnboarding
completeUserActionForSmartFlexOnboarding
completeUserInputRequiredForSmartFlexOnboarding
createAccountReference
createFlexShellAccount
createPostEvents
deauthenticateDevice
deauthenticateFlexDevice
deleteBoostCharge
deviceRegistration
fetchGeneratePaymentFingerprint
obtainKrakenToken
obtainLongLivedRefreshToken
ocppAuthentication
requestPasswordReset
resetUserPassword
resumeControl
selectChargePointMakeForSmartFlexOnboarding
selectChargePointVariantForSmartFlexOnboarding
selectDeviceTypeForSmartFlexOnboarding
selectFromListForSmartFlexOnboarding
selectHeatPumpMakeForSmartFlexOnboarding
selectInverterMakeForSmartFlexOnboarding
selectUserVehicleForSmartFlexOnboarding
selectVehicleMakeForSmartFlexOnboarding
selectVehicleOrChargePointForSmartFlexOnboarding
selectVehicleVariantForSmartFlexOnboarding
setClimateControlState
setDevicePreferences
setHotWaterState
setRoomTemperature
setVehicleChargePreferences
startReAuthentication
startSmartFlexOnboarding
startTestChargeForSmartFlexOnboarding
suspendControl
thirdPartyCompleteDeviceRegistration
triggerBoostCharge
triggerTestCharge
updateBoostCharge
updateDeviceGridExport
updateDeviceSmartControl
updateIsChargingDurationCapped
updateOptionsLanguagePreference
updateUser

Every GraphQL schema has a root type for both queries and mutations. The mutation type defines GraphQL operations that change data on the server. It is analogous to performing HTTP verbs such as POST, PATCH, and DELETE.

API Site

backendScreenEvent

Type:BackendScreenEvent

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Look up an event to perform from its event_id, and return the next action to perform.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-8002: No event found.
KT-CT-8003: Event has no execute function.
KT-CT-8004: Error executing event in the backend.
KT-CT-8007: Incorrect or missing parameters for backend screen event.
KT-GB-9310: Account ineligible for joining Octoplus.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

Name	Description
`input` (`BackendScreenEventInput!`)	Input fields for performing a backend action.

input (BackendScreenEventInput!)

Input fields for performing a backend action.

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

The 'possibleErrors' field is deprecated.

Please use the 'possibleErrors' query or the 'X-Kraken-Possible-Errors' header instead.

- Marked as deprecated on 2025-01-31.
- Scheduled for removal on or after 2025-03-01.

action (ActionType)

An action to perform.

mutation BackendScreenEvent($input: BackendScreenEventInput!) {
  backendScreenEvent(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    action {
      ... on DeeplinkActionType {
        ...DeeplinkActionTypeFragment
      }
      ... on LinkActionType {
        ...LinkActionTypeFragment
      }
      ... on BackendScreenEventActionType {
        ...BackendScreenEventActionTypeFragment
      }
      ... on CloseActionType {
        ...CloseActionTypeFragment
      }
      ... on ScreenActionType {
        ...ScreenActionTypeFragment
      }
      ... on ShowInputFieldErrorsActionType {
        ...ShowInputFieldErrorsActionTypeFragment
      }
    }
  }
}

{
  "input": BackendScreenEventInput
}

{
  "data": {
    "backendScreenEvent": {
      "possibleErrors": [PossibleErrorType],
      "action": DeeplinkActionType
    }
  }
}

cancelSmartFlexOnboarding

Type:CancelSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Cancel onboarding of a device with SmartFlex.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`CancelSmartFlexOnboardingInput!`)

input (CancelSmartFlexOnboardingInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation CancelSmartFlexOnboarding($input: CancelSmartFlexOnboardingInput!) {
  cancelSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": CancelSmartFlexOnboardingInput
}

{
  "data": {
    "cancelSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

completeAuthFlowForSmartFlexOnboarding

Type:CompleteAuthFlowForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Complete the authentication flow to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`CompleteAuthFlowInput!`)

input (CompleteAuthFlowInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation CompleteAuthFlowForSmartFlexOnboarding($input: CompleteAuthFlowInput!) {
  completeAuthFlowForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": CompleteAuthFlowInput
}

{
  "data": {
    "completeAuthFlowForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

completeTeslaSetupVirtualKeyForSmartFlexOnboarding

Type:CompleteTeslaSetupVirtualKeyForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Complete the Tesla virtual key setup onboarding step.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`CompleteSmartFlexOnboardingStepInput!`)

input (CompleteSmartFlexOnboardingStepInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation CompleteTeslaSetupVirtualKeyForSmartFlexOnboarding($input: CompleteSmartFlexOnboardingStepInput!) {
  completeTeslaSetupVirtualKeyForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": CompleteSmartFlexOnboardingStepInput
}

{
  "data": {
    "completeTeslaSetupVirtualKeyForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

completeUserActionForSmartFlexOnboarding

Type:CompleteUserActionRequiredForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Complete the user action required step to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`CompleteSmartFlexOnboardingStepInput!`)

input (CompleteSmartFlexOnboardingStepInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation CompleteUserActionForSmartFlexOnboarding($input: CompleteSmartFlexOnboardingStepInput!) {
  completeUserActionForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": CompleteSmartFlexOnboardingStepInput
}

{
  "data": {
    "completeUserActionForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

completeUserInputRequiredForSmartFlexOnboarding

Type:CompleteUserInputRequiredForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Complete the user input required step to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`UserInputRequiredInput!`)

input (UserInputRequiredInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation CompleteUserInputRequiredForSmartFlexOnboarding($input: UserInputRequiredInput!) {
  completeUserInputRequiredForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": UserInputRequiredInput
}

{
  "data": {
    "completeUserInputRequiredForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

createAccountReference

Type:CreateAccountReference

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Create an account reference.

The possible errors that can be raised are:

KT-CT-4123: Unauthorized.
KT-CT-8310: Invalid data.
KT-CT-8311: Invalid data.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`AccountReferenceInput!`)	Input fields for creating an account reference.

input (AccountReferenceInput!)

Input fields for creating an account reference.

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

accountReference (AccountReferenceType)

mutation CreateAccountReference($input: AccountReferenceInput!) {
  createAccountReference(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    accountReference {
      ...AccountReferenceTypeFragment
    }
  }
}

{
  "input": AccountReferenceInput
}

{
  "data": {
    "createAccountReference": {
      "possibleErrors": [PossibleErrorType],
      "accountReference": AccountReferenceType
    }
  }
}

createFlexShellAccount

Type:CreateFlexShellAccount

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Create a ResiFlex account with minimal information.

ResiFlex accounts are shell accounts that contain only essential data needed for device onboarding and API authentication. Most account management happens in the client's CRM system.

The possible errors that can be raised are:

KT-CT-4110: Unable to create account.
KT-CT-4131: Invalid brand.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`CreateFlexShellAccountInput!`)	Input fields for creating a ResiFlex account.

input (CreateFlexShellAccountInput!)

Input fields for creating a ResiFlex account.

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

account (AccountType)

The created ResiFlex account.

mutation CreateFlexShellAccount($input: CreateFlexShellAccountInput!) {
  createFlexShellAccount(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    account {
      ...AccountTypeFragment
    }
  }
}

{
  "input": CreateFlexShellAccountInput
}

{
  "data": {
    "createFlexShellAccount": {
      "possibleErrors": [PossibleErrorType],
      "account": AccountType
    }
  }
}

createPostEvents

Type:CreatePostEvents

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Create post delivery events from external vendors.

The possible errors that can be raised are:

KT-CT-9907: Post events batch size exceeded.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`CreatePostEventsInput!`)	Batch of post events to create.

input (CreatePostEventsInput!)

Batch of post events to create.

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

createdEventsCount (Int)

Number of events successfully created.

mutation CreatePostEvents($input: CreatePostEventsInput!) {
  createPostEvents(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    createdEventsCount
  }
}

{
  "input": CreatePostEventsInput
}

{
  "data": {
    "createPostEvents": {
      "possibleErrors": [PossibleErrorType],
      "createdEventsCount": 1
    }
  }
}

deauthenticateDevice

Type:DeauthenticateDevice

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

De-authenticate a device.

The possible errors that can be raised are:

KT-CT-4301: Unable to find device for given account.
KT-CT-4350: Unable to de-authenticate device.
KT-CT-4352: This device cannot currently be de-authenticated.
KT-CT-1113: Disabled GraphQL field requested.

Deprecated

The 'deauthenticateDevice' field is deprecated.

Please use 'deauthenticateFlexDevice' instead.

- Marked as deprecated on 2025-05-12.
- Scheduled for removal on or after 2026-01-16.

You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/606/

Arguments

Name Description

Name	Description
`input` (`DeAuthenticationInput`)

input (DeAuthenticationInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (DeviceDetailsType)

mutation DeauthenticateDevice($input: DeAuthenticationInput) {
  deauthenticateDevice(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...DeviceDetailsTypeFragment
    }
  }
}

{
  "input": DeAuthenticationInput
}

{
  "data": {
    "deauthenticateDevice": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": DeviceDetailsType
    }
  }
}

deauthenticateFlexDevice

Type:DeauthenticateFlexDevice

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

De-authenticate a device by device id.

The possible errors that can be raised are:

KT-CT-4350: Unable to de-authenticate device.
KT-CT-4352: This device cannot currently be de-authenticated.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

Name	Description
`input` (`DeauthenticateFlexDeviceInput`)

input (DeauthenticateFlexDeviceInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (DeviceDetailsType)

mutation DeauthenticateFlexDevice($input: DeauthenticateFlexDeviceInput) {
  deauthenticateFlexDevice(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...DeviceDetailsTypeFragment
    }
  }
}

{
  "input": DeauthenticateFlexDeviceInput
}

{
  "data": {
    "deauthenticateFlexDevice": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": DeviceDetailsType
    }
  }
}

deleteBoostCharge

Type:DeleteBoostCharge

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Stop any active boost charging.

The possible errors that can be raised are:

KT-CT-4301: Unable to find device for given account.
KT-CT-4354: Unable to cancel boost charge.
KT-CT-1113: Disabled GraphQL field requested.

Deprecated

The 'deleteBoostCharge' field is deprecated.

Please use 'updateBoostCharge' instead.

- Marked as deprecated on 2025-05-12.
- Scheduled for removal on or after 2026-01-26.

You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/607/

Arguments

Name Description

Name	Description
`input` (`DeleteBoostChargeInput`)

input (DeleteBoostChargeInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (KrakenFlexDeviceType)

mutation DeleteBoostCharge($input: DeleteBoostChargeInput) {
  deleteBoostCharge(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...KrakenFlexDeviceTypeFragment
    }
  }
}

{
  "input": DeleteBoostChargeInput
}

{
  "data": {
    "deleteBoostCharge": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": KrakenFlexDeviceType
    }
  }
}

deviceRegistration

Type:DeviceRegistration

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

The possible errors that can be raised are:

KT-CT-4324: Device already registered error.
KT-CT-4321: Serializer validation error.
KT-CT-4312: Unable to register device.
KT-CT-4363: No capable devices found.
KT-CT-4364: Multiple devices found.
KT-CT-1113: Disabled GraphQL field requested.

Deprecated

The 'deviceRegistration' field is deprecated.

Please use 'startSmartFlexOnboarding' instead.

- Marked as deprecated on 2025-09-08.
- Scheduled for removal on or after 2026-03-01.

You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/678/

Arguments

Name Description

Name	Description
`input` (`DeviceRegistrationInput`)

input (DeviceRegistrationInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

registeredDeviceIds ([String])

Device ID(s) of the registered device(s).

mutation DeviceRegistration($input: DeviceRegistrationInput) {
  deviceRegistration(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    registeredDeviceIds
  }
}

{
  "input": DeviceRegistrationInput
}

{
  "data": {
    "deviceRegistration": {
      "possibleErrors": [PossibleErrorType],
      "registeredDeviceIds": ["abc123"]
    }
  }
}

fetchGeneratePaymentFingerprint

Type:FetchGeneratePaymentFingerprint

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Fetch or generate payment fingerprint from vendor.

The possible errors that can be raised are:

KT-CT-12101: Payment instruction not found.
KT-CT-12102: Payment vendor not supported.
KT-CT-12103: Missing payment metadata from vendor.
KT-CT-12104: Unable to fetch or generate payment fingerprint.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`FetchGeneratePaymentFingerprintInput!`)

input (FetchGeneratePaymentFingerprintInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

fingerprint (String)

Fetched or generated fingerprint from vendor.

vendor (String)

Vendor name.

mutation FetchGeneratePaymentFingerprint($input: FetchGeneratePaymentFingerprintInput!) {
  fetchGeneratePaymentFingerprint(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    fingerprint
    vendor
  }
}

{
  "input": FetchGeneratePaymentFingerprintInput
}

{
  "data": {
    "fetchGeneratePaymentFingerprint": {
      "possibleErrors": [PossibleErrorType],
      "fingerprint": "abc123",
      "vendor": "abc123"
    }
  }
}

obtainKrakenToken

Type:ObtainKrakenJSONWebToken

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Create a Kraken Token (JWT) for authentication.

Provide the required input fields to obtain the token.

The token should be used as the Authorization header for any authenticated requests.

The possible errors that can be raised are:

KT-CT-1135: Invalid data.
KT-CT-1134: Invalid data.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

Name	Description
`input` (`ObtainJSONWebTokenInput!`)	Input fields that can be used to obtain a Json Web Token (JWT) for authentication to the API.

input (ObtainJSONWebTokenInput!)

Input fields that can be used to obtain a Json Web Token (JWT) for authentication to the API.

Return fields

Name	Description
`possibleErrors` (`[PossibleErrorType]`)	Field with the possible errors of the query/mutation. Deprecated The 'possibleErrors' field is deprecated. Please use the 'possibleErrors' query or the 'X-Kraken-Possible-Errors' header instead. - Marked as deprecated on 2025-01-31. - Scheduled for removal on or after 2025-03-01.
`token` (`String!`)	The Kraken Token. Can be used in the `Authorization` header for subsequent calls to the API to access protected resources.
`payload` (`GenericScalar!`)	The body payload of the Kraken Token. The same information can be obtained by using JWT decoding tools on the value of the `token` field.
`refreshToken` (`String`)	A token that can be used in a subsequent call to `obtainKrakenToken` to get a new Kraken Token with the same access conditions after the previous one has expired.
`refreshExpiresIn` (`Int`)	A Unix timestamp representing the point in time at which the refresh token will expire.

mutation ObtainKrakenToken($input: ObtainJSONWebTokenInput!) {
  obtainKrakenToken(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    token
    payload
    refreshToken
    refreshExpiresIn
  }
}

{
  "input": ObtainJSONWebTokenInput
}

{
  "data": {
    "obtainKrakenToken": {
      "possibleErrors": [PossibleErrorType],
      "token": "abc123",
      "payload": "abc123" | 1 | 1.0 | true | ["abc123"] | AccountType,
      "refreshToken": "abc123",
      "refreshExpiresIn": 1
    }
  }
}

obtainLongLivedRefreshToken

Type:ObtainLongLivedRefreshToken

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

For authorized third-party organizations only.

The possible errors that can be raised are:

KT-CT-1120: The Kraken Token has expired.
KT-CT-1121: Please use Kraken Token to issue long-lived refresh tokens.
KT-CT-1132: Unauthorized.
KT-CT-1122: Long-lived refresh tokens can only be issued for account users.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`ObtainLongLivedRefreshTokenInput!`)	Input fields for obtaining a long-lived refresh token to extend the expiry claim of a Kraken token.

input (ObtainLongLivedRefreshTokenInput!)

Input fields for obtaining a long-lived refresh token to extend the expiry claim of a Kraken token.

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

refreshToken (String)

refreshExpiresIn (Int!)

mutation ObtainLongLivedRefreshToken($input: ObtainLongLivedRefreshTokenInput!) {
  obtainLongLivedRefreshToken(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    refreshToken
    refreshExpiresIn
  }
}

{
  "input": ObtainLongLivedRefreshTokenInput
}

{
  "data": {
    "obtainLongLivedRefreshToken": {
      "possibleErrors": [PossibleErrorType],
      "refreshToken": "abc123",
      "refreshExpiresIn": 1
    }
  }
}

ocppAuthentication

Type:OCPPAuthentication

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Trigger OCPP authentication.

The possible errors that can be raised are:

KT-CT-4301: Unable to find device for given account.
KT-CT-4310: Unable to register OCPP authentication details.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

Name	Description
`input` (`OCPPAuthenticationInput`)

input (OCPPAuthenticationInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (KrakenFlexDeviceType)

mutation OcppAuthentication($input: OCPPAuthenticationInput) {
  ocppAuthentication(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...KrakenFlexDeviceTypeFragment
    }
  }
}

{
  "input": OCPPAuthenticationInput
}

{
  "data": {
    "ocppAuthentication": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": KrakenFlexDeviceType
    }
  }
}

requestPasswordReset

Type:RequestPasswordResetOutputType

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Provide the email address of an account user to send them an email with instructions on how to reset their password.

The possible errors that can be raised are:

KT-CT-11331: Invalid input data.
KT-CT-11332: Invalid data.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

Name	Description
`input` (`RequestPasswordResetInput!`)	Input fields for requesting a password reset email.

input (RequestPasswordResetInput!)

Input fields for requesting a password reset email.

Return fields

Name Description

Name	Description
`email` (`String`)	The email that requested a password reset email.
`userNumber` (`String`)	The number of the user that requested a password reset email.

email (String)

The email that requested a password reset email.

userNumber (String)

The number of the user that requested a password reset email.

mutation RequestPasswordReset($input: RequestPasswordResetInput!) {
  requestPasswordReset(input: $input) {
    email
    userNumber
  }
}

{
  "input": RequestPasswordResetInput
}

{
  "data": {
    "requestPasswordReset": {
      "email": "abc123",
      "userNumber": "abc123"
    }
  }
}

resetUserPassword

Type:ResetUserPasswordOutput

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Reset the password of an account user.

Raises KT-CT-5450 if password validation fails. Inspect the validationErrors extension to get the exact validation error:

json { "data": {"resetUserPassword": null}, "errors": [ { "message": "Password is invalid.", "path": ["resetUserPassword"], "extensions": { "errorType": "VALIDATION", "errorCode": "KT-CT-5450", "errorDescription": "Given password fails password policy requirements.", "validationErrors": [ { "code": "password_too_short", "message": "This password is too short. It must contain at least 7 characters.", "inputPath": ["input", "password"] }, { "code": "password_too_common", "message": "This password is too common.", "inputPath": ["input", "password"] } ] } } ] }

The validation error's code can be any of - password_too_short - password_too_common - password_reused - password_matches_current - password_has_too_few_numeric_characters - password_has_too_few_special_characters - password_has_too_few_lowercase_characters - password_has_too_few_uppercase_characters - password_contains_account_number - password_contains_part_of_email_address

The possible errors that can be raised are:

KT-CT-4125: Unauthorized.
KT-CT-1132: Unauthorized.
KT-CT-5450: Password is invalid.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

Name	Description
`input` (`ResetUserPasswordInput!`)	Input fields for resetting an account user's password.

input (ResetUserPasswordInput!)

Input fields for resetting an account user's password.

Return fields

Name	Description
`userId` (`ID!`)	The ID of the user whose password was changed.
`passwordUpdated` (`Boolean`)	True if the password update was successful, false otherwise. Deprecated The 'passwordUpdated' field is deprecated. Please handle the KT-CT-5450 error instead. Note that the KT-CT-5450 error will not be raised if you request any of the `failureCodes`, `failureReasons`, or `passwordUpdated` fields. - Marked as deprecated on 2025-04-07. - Scheduled for removal on or after 2025-10-04.
`failureReasons` (`[String]`)	A list of messages of which password validations the new password failed against if applicable. Deprecated The 'failureReasons' field is deprecated. Please handle the KT-CT-5450 error and inspect the `validationErrors[].message` extension instead. Note that the KT-CT-5450 error will not be raised if you request any of the `failureCodes`, `failureReasons`, or `passwordUpdated` fields. - Marked as deprecated on 2025-04-07. - Scheduled for removal on or after 2025-10-04.
`failureCodes` (`[String]`)	A list of codes of which password validation the new password failed against if applicable. One of: - `password_too_short` - `password_too_common` - `password_reused` - `password_matches_current` - `password_has_too_few_numeric_characters` - `password_has_too_few_special_characters` - `password_has_too_few_lowercase_characters` - `password_has_too_few_uppercase_characters` - `password_contains_account_number` - `password_contains_part_of_email_address` Deprecated The 'failureCodes' field is deprecated. Please handle the KT-CT-5450 error and inspect the `validationErrors[].code` extension instead. Note that the KT-CT-5450 error will not be raised if you request any of the `failureCodes`, `failureReasons`, or `passwordUpdated` fields. - Marked as deprecated on 2025-04-07. - Scheduled for removal on or after 2025-10-04.

mutation ResetUserPassword($input: ResetUserPasswordInput!) {
  resetUserPassword(input: $input) {
    userId
    passwordUpdated
    failureReasons
    failureCodes
  }
}

{
  "input": ResetUserPasswordInput
}

{
  "data": {
    "resetUserPassword": {
      "userId": "abc123",
      "passwordUpdated": true,
      "failureReasons": ["abc123"],
      "failureCodes": ["abc123"]
    }
  }
}

resumeControl

Type:ResumeDeviceControl

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Resume control of the device.

The possible errors that can be raised are:

KT-CT-4301: Unable to find device for given account.
KT-CT-4359: Unable to resume device control.
KT-CT-1113: Disabled GraphQL field requested.

Deprecated

The 'resumeControl' field is deprecated.

Please use 'updateDeviceSmartControl' instead.

- Marked as deprecated on 2024-09-17.
- Scheduled for removal on or after 2025-12-11.

You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/468/

Arguments

Name Description

Name	Description
`input` (`AccountNumberInput`)

input (AccountNumberInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (KrakenFlexDeviceType)

mutation ResumeControl($input: AccountNumberInput) {
  resumeControl(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...KrakenFlexDeviceTypeFragment
    }
  }
}

{
  "input": AccountNumberInput
}

{
  "data": {
    "resumeControl": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": KrakenFlexDeviceType
    }
  }
}

selectChargePointMakeForSmartFlexOnboarding

Type:SelectChargePointMakeForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the charge point make to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectChargePointMakeForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

Name	Description
`input` (`SelectChargePointMakeInput!`)

input (SelectChargePointMakeInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectChargePointMakeForSmartFlexOnboarding($input: SelectChargePointMakeInput!) {
  selectChargePointMakeForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectChargePointMakeInput
}

{
  "data": {
    "selectChargePointMakeForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectChargePointVariantForSmartFlexOnboarding

Type:SelectChargePointVariantForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the charge point model variant to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectChargePointVariantForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

Name	Description
`input` (`SelectChargePointVariantInput!`)

input (SelectChargePointVariantInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectChargePointVariantForSmartFlexOnboarding($input: SelectChargePointVariantInput!) {
  selectChargePointVariantForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectChargePointVariantInput
}

{
  "data": {
    "selectChargePointVariantForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectDeviceTypeForSmartFlexOnboarding

Type:SelectDeviceTypeForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the device type to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectDeviceTypeForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

Name	Description
`input` (`SelectDeviceTypeInput!`)

input (SelectDeviceTypeInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectDeviceTypeForSmartFlexOnboarding($input: SelectDeviceTypeInput!) {
  selectDeviceTypeForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectDeviceTypeInput
}

{
  "data": {
    "selectDeviceTypeForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectFromListForSmartFlexOnboarding

Type:SelectFromListForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select from a list of options presented.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

Name	Description
`input` (`SelectFromListInput!`)

input (SelectFromListInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectFromListForSmartFlexOnboarding($input: SelectFromListInput!) {
  selectFromListForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectFromListInput
}

{
  "data": {
    "selectFromListForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectHeatPumpMakeForSmartFlexOnboarding

Type:SelectHeatPumpMakeForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the heat pump make to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectHeatPumpMakeForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

Name	Description
`input` (`SelectHeatPumpMakeInput!`)

input (SelectHeatPumpMakeInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectHeatPumpMakeForSmartFlexOnboarding($input: SelectHeatPumpMakeInput!) {
  selectHeatPumpMakeForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectHeatPumpMakeInput
}

{
  "data": {
    "selectHeatPumpMakeForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectInverterMakeForSmartFlexOnboarding

Type:SelectInverterMakeForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the inverter make to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectInverterMakeForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

input (SelectInverterMakeInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectInverterMakeForSmartFlexOnboarding($input: SelectInverterMakeInput!) {
  selectInverterMakeForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectInverterMakeInput
}

{
  "data": {
    "selectInverterMakeForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectUserVehicleForSmartFlexOnboarding

Type:SelectUserVehicleForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the user's vehicle to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectUserVehicleForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

input (SelectUserVehicleInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectUserVehicleForSmartFlexOnboarding($input: SelectUserVehicleInput!) {
  selectUserVehicleForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectUserVehicleInput
}

{
  "data": {
    "selectUserVehicleForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectVehicleMakeForSmartFlexOnboarding

Type:SelectVehicleMakeForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the vehicle make to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectVehicleMakeForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

input (SelectVehicleMakeInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectVehicleMakeForSmartFlexOnboarding($input: SelectVehicleMakeInput!) {
  selectVehicleMakeForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectVehicleMakeInput
}

{
  "data": {
    "selectVehicleMakeForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectVehicleOrChargePointForSmartFlexOnboarding

Type:CompleteSelectVehicleOrChargePointForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the vehicle or charge point for the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (SelectVehicleOrChargePointInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectVehicleOrChargePointForSmartFlexOnboarding($input: SelectVehicleOrChargePointInput!) {
  selectVehicleOrChargePointForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectVehicleOrChargePointInput
}

{
  "data": {
    "selectVehicleOrChargePointForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

selectVehicleVariantForSmartFlexOnboarding

Type:SelectVehicleVariantForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Select the vehicle model variant to proceed in the onboarding journey.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'selectVehicleVariantForSmartFlexOnboarding' field is deprecated.

Please use 'selectFromListForSmartFlexOnboarding' instead.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

input (SelectVehicleVariantInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation SelectVehicleVariantForSmartFlexOnboarding($input: SelectVehicleVariantInput!) {
  selectVehicleVariantForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": SelectVehicleVariantInput
}

{
  "data": {
    "selectVehicleVariantForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

setClimateControlState

Type:SetClimateControlState

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Turn a hot water device on or off.

The possible errors that can be raised are:

KT-CT-4337: Unable to set climate control state.
KT-CT-4301: Unable to find device for given account.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

input (ClimateControlStateInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

heatPumpDevice (HeatPumpDeviceType)

The customer specific heat pump device details.

mutation SetClimateControlState($input: ClimateControlStateInput) {
  setClimateControlState(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    heatPumpDevice {
      ...HeatPumpDeviceTypeFragment
    }
  }
}

{
  "input": ClimateControlStateInput
}

{
  "data": {
    "setClimateControlState": {
      "possibleErrors": [PossibleErrorType],
      "heatPumpDevice": HeatPumpDeviceType
    }
  }
}

setDevicePreferences

Type:SmartFlexDeviceInterface

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Set the user preferences for a device.

The possible errors that can be raised are:

KT-CT-4314: Unable to get provider details.
KT-CT-4321: Serializer validation error.
KT-CT-4374: An error occurred while trying to set your device preferences.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (SmartFlexDevicePreferencesInput!)

The device preference details to be updated.

Return fields

Name	Description
`id` (`ID!`)	A UUID that identifies this device registration. Re-registering this device will result in a different ID.
`name` (`String`)	The user-friendly name for the device.
`deviceType` (`KrakenFlexDeviceTypes!`)	The type of device.
`provider` (`ProviderChoices!`)	The third-party that enables control of this device.
`integrationDeviceId` (`String`)	The third-party integration device ID.
`status` (`SmartFlexDeviceStatusInterface!`)	Information about the current status of this device.
`propertyId` (`String`)	The id of the property linked to the device.
`alerts` (`[SmartFlexDeviceAlertInterface]`)	Active alert message(s) for a device, showing the latest first.
`onboardingWizard` (`SmartFlexOnboardingWizard`)	The current onboarding wizard for a device.
`preferences` (`SmartFlexDevicePreferencesInterface`)	The device's preference details.
`preferenceSetting` (`FlexDevicePreferenceSettingInterface`)	The preference setting for this device.
`reAuthenticationState` (`DeviceReAuthenticationInterface`)	The re-authentication state of this device, if applicable.

mutation SetDevicePreferences($input: SmartFlexDevicePreferencesInput!) {
  setDevicePreferences(input: $input) {
    id
    name
    deviceType
    provider
    integrationDeviceId
    status {
      ...SmartFlexDeviceStatusInterfaceFragment
    }
    propertyId
    alerts {
      ...SmartFlexDeviceAlertInterfaceFragment
    }
    onboardingWizard {
      ...SmartFlexOnboardingWizardFragment
    }
    preferences {
      ...SmartFlexDevicePreferencesInterfaceFragment
    }
    preferenceSetting {
      ...FlexDevicePreferenceSettingInterfaceFragment
    }
    reAuthenticationState {
      ...DeviceReAuthenticationInterfaceFragment
    }
  }
}

{
  "input": SmartFlexDevicePreferencesInput
}

{
  "data": {
    "setDevicePreferences": {
      "id": "abc123",
      "name": "abc123",
      "deviceType": "BATTERIES",
      "provider": "BYD",
      "integrationDeviceId": "abc123",
      "status": SmartFlexDeviceStatusInterface,
      "propertyId": "abc123",
      "alerts": SmartFlexDeviceAlertInterface,
      "onboardingWizard": SmartFlexOnboardingWizard,
      "preferences": SmartFlexDevicePreferencesInterface,
      "preferenceSetting": FlexDevicePreferenceSettingInterface,
      "reAuthenticationState": DeviceReAuthenticationInterface
    }
  }
}

setHotWaterState

Type:SetHotWaterState

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Turn a hot water device on or off.

The possible errors that can be raised are:

KT-CT-4336: Unable to set hot water state.
KT-CT-4301: Unable to find device for given account.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

input (HotWaterStateInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

heatPumpDevice (HeatPumpDeviceType)

The customer specific heat pump device details.

mutation SetHotWaterState($input: HotWaterStateInput) {
  setHotWaterState(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    heatPumpDevice {
      ...HeatPumpDeviceTypeFragment
    }
  }
}

{
  "input": HotWaterStateInput
}

{
  "data": {
    "setHotWaterState": {
      "possibleErrors": [PossibleErrorType],
      "heatPumpDevice": HeatPumpDeviceType
    }
  }
}

setRoomTemperature

Type:SetRoomTemperature

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Turn a hot water device on or off.

The possible errors that can be raised are:

KT-CT-4329: Invalid data.
KT-CT-4346: Unable to set the room temperature.
KT-CT-7223: Unauthorized.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

input (RoomTemperatureInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

heatPumpDevice (HeatPumpDeviceType)

The customer specific heat pump device details.

mutation SetRoomTemperature($input: RoomTemperatureInput) {
  setRoomTemperature(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    heatPumpDevice {
      ...HeatPumpDeviceTypeFragment
    }
  }
}

{
  "input": RoomTemperatureInput
}

{
  "data": {
    "setRoomTemperature": {
      "possibleErrors": [PossibleErrorType],
      "heatPumpDevice": HeatPumpDeviceType
    }
  }
}

setVehicleChargePreferences

Type:SetVehicleChargingPreferences

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Set charging preferences for your electric vehicle.

The possible errors that can be raised are:

KT-CT-4301: Unable to find device for given account.
KT-CT-4321: Serializer validation error.
KT-CT-4353: An error occurred while trying to update your charging preferences.
KT-CT-1113: Disabled GraphQL field requested.

Deprecated

The 'setVehicleChargePreferences' field is deprecated.

Please use `setDevicePreferences` instead of this endpoint.

- Marked as deprecated on 2024-09-18.
- Scheduled for removal on or after 2026-01-26.

You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/469/

Arguments

Name Description

input (VehicleChargingPreferencesInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (KrakenFlexDeviceType)

mutation SetVehicleChargePreferences($input: VehicleChargingPreferencesInput) {
  setVehicleChargePreferences(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...KrakenFlexDeviceTypeFragment
    }
  }
}

{
  "input": VehicleChargingPreferencesInput
}

{
  "data": {
    "setVehicleChargePreferences": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": KrakenFlexDeviceType
    }
  }
}

startReAuthentication

Type:StartReAuthentication

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Create a wizard for re-authenticating a device with SmartFlex.

The possible errors that can be raised are:

KT-CT-4321: Serializer validation error.
KT-CT-4385: Re-authentication is not supported for this device.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (StartReAuthenticationInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for re-authenticating the device with SmartFlex.

mutation StartReAuthentication($input: StartReAuthenticationInput!) {
  startReAuthentication(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": StartReAuthenticationInput
}

{
  "data": {
    "startReAuthentication": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

startSmartFlexOnboarding

Type:StartSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Create a wizard for onboarding a device with SmartFlex.

The possible errors that can be raised are:

KT-CT-4321: Serializer validation error.
KT-CT-4385: Re-authentication is not supported for this device.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (StartSmartFlexOnboardingInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation StartSmartFlexOnboarding($input: StartSmartFlexOnboardingInput!) {
  startSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": StartSmartFlexOnboardingInput
}

{
  "data": {
    "startSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

startTestChargeForSmartFlexOnboarding

Type:StartTestChargeForSmartFlexOnboarding

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Attempt to start a test charge.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4371: Onboarding wizard ID is invalid.
KT-CT-4372: Simultaneous attempts to update onboarding process.
KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
KT-CT-4376: Unable to complete onboarding step. Please try again later.
KT-CT-4377: Invalid onboarding step ID.
KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
KT-CT-4379: Vehicle is not ready for a test charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'startTestChargeForSmartFlexOnboarding' field is deprecated.

This functionality will no longer be available.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

input (CompleteSmartFlexOnboardingStepInput!)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

mutation StartTestChargeForSmartFlexOnboarding($input: CompleteSmartFlexOnboardingStepInput!) {
  startTestChargeForSmartFlexOnboarding(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    wizard {
      ...SmartFlexOnboardingWizardFragment
    }
  }
}

{
  "input": CompleteSmartFlexOnboardingStepInput
}

{
  "data": {
    "startTestChargeForSmartFlexOnboarding": {
      "possibleErrors": [PossibleErrorType],
      "wizard": SmartFlexOnboardingWizard
    }
  }
}

suspendControl

Type:SuspendDeviceControl

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Suspend control of the device.

The possible errors that can be raised are:

KT-CT-4301: Unable to find device for given account.
KT-CT-4358: Unable to suspend device control.
KT-CT-1113: Disabled GraphQL field requested.

Deprecated

The 'suspendControl' field is deprecated.

Please use 'updateDeviceSmartControl' instead.

- Marked as deprecated on 2024-09-17.
- Scheduled for removal on or after 2025-12-11.

You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/468/

Arguments

Name Description

input (AccountNumberInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (KrakenFlexDeviceType)

mutation SuspendControl($input: AccountNumberInput) {
  suspendControl(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...KrakenFlexDeviceTypeFragment
    }
  }
}

{
  "input": AccountNumberInput
}

{
  "data": {
    "suspendControl": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": KrakenFlexDeviceType
    }
  }
}

thirdPartyCompleteDeviceRegistration

Type:ThirdPartyCompleteDeviceRegistration

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Completes the registration of a device if the contract is eligible and the device registration valid.

The possible errors that can be raised are:

KT-CT-4321: Serializer validation error.
KT-CT-4322: Unable to complete registration error.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Deprecated

The 'thirdPartyCompleteDeviceRegistration' field is deprecated.

This functionality will no longer be available.

- Marked as deprecated on 2026-01-05.
- Scheduled for removal on or after 2026-07-05.

Arguments

Name Description

input (CompleteDeviceRegistrationInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

success (ThirdPartyCompleteDeviceRegistrationType)

The response showing account validity and optional tariff information.

mutation ThirdPartyCompleteDeviceRegistration($input: CompleteDeviceRegistrationInput) {
  thirdPartyCompleteDeviceRegistration(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    success {
      ...ThirdPartyCompleteDeviceRegistrationTypeFragment
    }
  }
}

{
  "input": CompleteDeviceRegistrationInput
}

{
  "data": {
    "thirdPartyCompleteDeviceRegistration": {
      "possibleErrors": [PossibleErrorType],
      "success": ThirdPartyCompleteDeviceRegistrationType
    }
  }
}

triggerBoostCharge

Type:PerformBoostCharge

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Initiate a boost charge for an electric vehicle (EV).

This will start charging the EV and will not stop until the battery reaches 100% charged.

If it is not possible to initiate a boost charge, a KT-CT-4357 error will be returned. It may have a boostChargeRefusalReasons extension which lists the reasons why the boost charge was refused. Possible reasons include:

BC_DEVICE_NOT_YET_LIVE (device is not yet live)
BC_DEVICE_RETIRED (device is retired)
BC_DEVICE_SUSPENDED (device is suspended)
BC_DEVICE_DISCONNECTED (device is disconnected)
BC_DEVICE_NOT_AT_HOME (device is not at home)
BC_BOOST_CHARGE_IN_PROGRESS (boost charge already in progress)
BC_DEVICE_FULLY_CHARGED (device is already fully charged)

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4356: A boost charge cannot currently be performed.
KT-CT-4357: Unable to trigger boost charge.
KT-CT-1113: Disabled GraphQL field requested.

Deprecated

The 'triggerBoostCharge' field is deprecated.

Please use 'updateBoostCharge' instead.

- Marked as deprecated on 2025-05-12.
- Scheduled for removal on or after 2026-01-26.

You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/607/

Arguments

Name Description

input (AccountNumberInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (KrakenFlexDeviceType)

mutation TriggerBoostCharge($input: AccountNumberInput) {
  triggerBoostCharge(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...KrakenFlexDeviceTypeFragment
    }
  }
}

{
  "input": AccountNumberInput
}

{
  "data": {
    "triggerBoostCharge": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": KrakenFlexDeviceType
    }
  }
}

triggerTestCharge

Type:PerformTestCharge

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Initiate a test charge of an electric vehicle (EV).

This is to ensure that the EV or EVSE (charge point) can be controlled remotely and successfully charged for a short period.

If it is not possible to initiate a test charge, a KT-CT-4355 error will be returned. It may have a testChargeRefusalReasons extension which lists the reasons why the test charge was refused. Possible reasons include:

TC_DEVICE_LIVE (device is already live)
TC_DEVICE_ONBOARDING_IN_PROGRESS (test dispatch already in progress)
TC_DEVICE_RETIRED (device is retired)
TC_DEVICE_SUSPENDED (device is suspended)
TC_DEVICE_DISCONNECTED (device is disconnected)
TC_DEVICE_ALREADY_CHARGING (device is already charging)
TC_DEVICE_AWAY_FROM_HOME (device is away from home)
TC_DEVICE_NO_LOCATION_CONFIGURED (device has no location configured)
TC_DEVICE_LOCATION_UNABLE_TO_IDENTIFY (unable to identify device location)
TC_DEVICE_LOCATION_MISSING (device location is missing)

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4362: Device not ready for test charge.
KT-CT-4355: Unable to trigger charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (AccountNumberInput)

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

krakenflexDevice (KrakenFlexDeviceType)

mutation TriggerTestCharge($input: AccountNumberInput) {
  triggerTestCharge(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    krakenflexDevice {
      ...KrakenFlexDeviceTypeFragment
    }
  }
}

{
  "input": AccountNumberInput
}

{
  "data": {
    "triggerTestCharge": {
      "possibleErrors": [PossibleErrorType],
      "krakenflexDevice": KrakenFlexDeviceType
    }
  }
}

updateBoostCharge

Type:SmartFlexDeviceInterface

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Update the boost charge for a specific device.

BC_DEVICE_NOT_YET_LIVE (device is not yet live)
BC_DEVICE_RETIRED (device is retired)
BC_DEVICE_SUSPENDED (device is suspended)
BC_DEVICE_DISCONNECTED (device is disconnected)
BC_DEVICE_NOT_AT_HOME (device is not at home)
BC_BOOST_CHARGE_IN_PROGRESS (boost charge already in progress)
BC_DEVICE_FULLY_CHARGED (device is already fully charged)

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4354: Unable to cancel boost charge.
KT-CT-4356: A boost charge cannot currently be performed.
KT-CT-4357: Unable to trigger boost charge.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (UpdateBoostChargeInput)

Return fields

Name	Description
`id` (`ID!`)	A UUID that identifies this device registration. Re-registering this device will result in a different ID.
`name` (`String`)	The user-friendly name for the device.
`deviceType` (`KrakenFlexDeviceTypes!`)	The type of device.
`provider` (`ProviderChoices!`)	The third-party that enables control of this device.
`integrationDeviceId` (`String`)	The third-party integration device ID.
`status` (`SmartFlexDeviceStatusInterface!`)	Information about the current status of this device.
`propertyId` (`String`)	The id of the property linked to the device.
`alerts` (`[SmartFlexDeviceAlertInterface]`)	Active alert message(s) for a device, showing the latest first.
`onboardingWizard` (`SmartFlexOnboardingWizard`)	The current onboarding wizard for a device.
`preferences` (`SmartFlexDevicePreferencesInterface`)	The device's preference details.
`preferenceSetting` (`FlexDevicePreferenceSettingInterface`)	The preference setting for this device.
`reAuthenticationState` (`DeviceReAuthenticationInterface`)	The re-authentication state of this device, if applicable.

mutation UpdateBoostCharge($input: UpdateBoostChargeInput) {
  updateBoostCharge(input: $input) {
    id
    name
    deviceType
    provider
    integrationDeviceId
    status {
      ...SmartFlexDeviceStatusInterfaceFragment
    }
    propertyId
    alerts {
      ...SmartFlexDeviceAlertInterfaceFragment
    }
    onboardingWizard {
      ...SmartFlexOnboardingWizardFragment
    }
    preferences {
      ...SmartFlexDevicePreferencesInterfaceFragment
    }
    preferenceSetting {
      ...FlexDevicePreferenceSettingInterfaceFragment
    }
    reAuthenticationState {
      ...DeviceReAuthenticationInterfaceFragment
    }
  }
}

{
  "input": UpdateBoostChargeInput
}

{
  "data": {
    "updateBoostCharge": {
      "id": "abc123",
      "name": "abc123",
      "deviceType": "BATTERIES",
      "provider": "BYD",
      "integrationDeviceId": "abc123",
      "status": SmartFlexDeviceStatusInterface,
      "propertyId": "abc123",
      "alerts": SmartFlexDeviceAlertInterface,
      "onboardingWizard": SmartFlexOnboardingWizard,
      "preferences": SmartFlexDevicePreferencesInterface,
      "preferenceSetting": FlexDevicePreferenceSettingInterface,
      "reAuthenticationState": DeviceReAuthenticationInterface
    }
  }
}

updateDeviceGridExport

Type:SmartFlexDeviceInterface

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Update the grid export preference for a device.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4386: An error occurred while trying to update your device's grid export status.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

input (UpdateDeviceGridExportInput)

Return fields

Name	Description
`id` (`ID!`)	A UUID that identifies this device registration. Re-registering this device will result in a different ID.
`name` (`String`)	The user-friendly name for the device.
`deviceType` (`KrakenFlexDeviceTypes!`)	The type of device.
`provider` (`ProviderChoices!`)	The third-party that enables control of this device.
`integrationDeviceId` (`String`)	The third-party integration device ID.
`status` (`SmartFlexDeviceStatusInterface!`)	Information about the current status of this device.
`propertyId` (`String`)	The id of the property linked to the device.
`alerts` (`[SmartFlexDeviceAlertInterface]`)	Active alert message(s) for a device, showing the latest first.
`onboardingWizard` (`SmartFlexOnboardingWizard`)	The current onboarding wizard for a device.
`preferences` (`SmartFlexDevicePreferencesInterface`)	The device's preference details.
`preferenceSetting` (`FlexDevicePreferenceSettingInterface`)	The preference setting for this device.
`reAuthenticationState` (`DeviceReAuthenticationInterface`)	The re-authentication state of this device, if applicable.

mutation UpdateDeviceGridExport($input: UpdateDeviceGridExportInput) {
  updateDeviceGridExport(input: $input) {
    id
    name
    deviceType
    provider
    integrationDeviceId
    status {
      ...SmartFlexDeviceStatusInterfaceFragment
    }
    propertyId
    alerts {
      ...SmartFlexDeviceAlertInterfaceFragment
    }
    onboardingWizard {
      ...SmartFlexOnboardingWizardFragment
    }
    preferences {
      ...SmartFlexDevicePreferencesInterfaceFragment
    }
    preferenceSetting {
      ...FlexDevicePreferenceSettingInterfaceFragment
    }
    reAuthenticationState {
      ...DeviceReAuthenticationInterfaceFragment
    }
  }
}

{
  "input": UpdateDeviceGridExportInput
}

{
  "data": {
    "updateDeviceGridExport": {
      "id": "abc123",
      "name": "abc123",
      "deviceType": "BATTERIES",
      "provider": "BYD",
      "integrationDeviceId": "abc123",
      "status": SmartFlexDeviceStatusInterface,
      "propertyId": "abc123",
      "alerts": SmartFlexDeviceAlertInterface,
      "onboardingWizard": SmartFlexOnboardingWizard,
      "preferences": SmartFlexDevicePreferencesInterface,
      "preferenceSetting": FlexDevicePreferenceSettingInterface,
      "reAuthenticationState": DeviceReAuthenticationInterface
    }
  }
}

updateDeviceSmartControl

Type:SmartFlexDeviceInterface

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Suspends or resumes the smart control of a specific device. For some devices, this will also adjust smart control of related devices. e.g. suspending one zone in a multi-zone heat pump system will suspend all zones in that system.

The possible errors that can be raised are:

KT-CT-4313: Could not find KrakenFlex device.
KT-CT-4314: Unable to get provider details.
KT-CT-4387: Could not find the KrakenFlex controller device.
KT-CT-4358: Unable to suspend device control.
KT-CT-4359: Unable to resume device control.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (SmartControlInput!)

The input to action the desired device control, i.e. suspend or unsuspend a device.

Return fields

Name	Description
`id` (`ID!`)	A UUID that identifies this device registration. Re-registering this device will result in a different ID.
`name` (`String`)	The user-friendly name for the device.
`deviceType` (`KrakenFlexDeviceTypes!`)	The type of device.
`provider` (`ProviderChoices!`)	The third-party that enables control of this device.
`integrationDeviceId` (`String`)	The third-party integration device ID.
`status` (`SmartFlexDeviceStatusInterface!`)	Information about the current status of this device.
`propertyId` (`String`)	The id of the property linked to the device.
`alerts` (`[SmartFlexDeviceAlertInterface]`)	Active alert message(s) for a device, showing the latest first.
`onboardingWizard` (`SmartFlexOnboardingWizard`)	The current onboarding wizard for a device.
`preferences` (`SmartFlexDevicePreferencesInterface`)	The device's preference details.
`preferenceSetting` (`FlexDevicePreferenceSettingInterface`)	The preference setting for this device.
`reAuthenticationState` (`DeviceReAuthenticationInterface`)	The re-authentication state of this device, if applicable.

mutation UpdateDeviceSmartControl($input: SmartControlInput!) {
  updateDeviceSmartControl(input: $input) {
    id
    name
    deviceType
    provider
    integrationDeviceId
    status {
      ...SmartFlexDeviceStatusInterfaceFragment
    }
    propertyId
    alerts {
      ...SmartFlexDeviceAlertInterfaceFragment
    }
    onboardingWizard {
      ...SmartFlexOnboardingWizardFragment
    }
    preferences {
      ...SmartFlexDevicePreferencesInterfaceFragment
    }
    preferenceSetting {
      ...FlexDevicePreferenceSettingInterfaceFragment
    }
    reAuthenticationState {
      ...DeviceReAuthenticationInterfaceFragment
    }
  }
}

{
  "input": SmartControlInput
}

{
  "data": {
    "updateDeviceSmartControl": {
      "id": "abc123",
      "name": "abc123",
      "deviceType": "BATTERIES",
      "provider": "BYD",
      "integrationDeviceId": "abc123",
      "status": SmartFlexDeviceStatusInterface,
      "propertyId": "abc123",
      "alerts": SmartFlexDeviceAlertInterface,
      "onboardingWizard": SmartFlexOnboardingWizard,
      "preferences": SmartFlexDevicePreferencesInterface,
      "preferenceSetting": FlexDevicePreferenceSettingInterface,
      "reAuthenticationState": DeviceReAuthenticationInterface
    }
  }
}

updateIsChargingDurationCapped

Type:SmartFlexDeviceInterface

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Update the charging duration cap preference for a device.

The possible errors that can be raised are:

KT-CT-1111: Unauthorized.
KT-CT-4389: An error occurred while trying to update your device's isChargingDurationCapped setting.
KT-CT-4390: An error occurred while trying to update your device's preference.
KT-CT-1113: Disabled GraphQL field requested.

Arguments

Name Description

input (UpdateIsChargingDurationCappedInput)

Input fields for updating the charging duration cap preference.

Return fields

Name	Description
`id` (`ID!`)	A UUID that identifies this device registration. Re-registering this device will result in a different ID.
`name` (`String`)	The user-friendly name for the device.
`deviceType` (`KrakenFlexDeviceTypes!`)	The type of device.
`provider` (`ProviderChoices!`)	The third-party that enables control of this device.
`integrationDeviceId` (`String`)	The third-party integration device ID.
`status` (`SmartFlexDeviceStatusInterface!`)	Information about the current status of this device.
`propertyId` (`String`)	The id of the property linked to the device.
`alerts` (`[SmartFlexDeviceAlertInterface]`)	Active alert message(s) for a device, showing the latest first.
`onboardingWizard` (`SmartFlexOnboardingWizard`)	The current onboarding wizard for a device.
`preferences` (`SmartFlexDevicePreferencesInterface`)	The device's preference details.
`preferenceSetting` (`FlexDevicePreferenceSettingInterface`)	The preference setting for this device.
`reAuthenticationState` (`DeviceReAuthenticationInterface`)	The re-authentication state of this device, if applicable.

mutation UpdateIsChargingDurationCapped($input: UpdateIsChargingDurationCappedInput) {
  updateIsChargingDurationCapped(input: $input) {
    id
    name
    deviceType
    provider
    integrationDeviceId
    status {
      ...SmartFlexDeviceStatusInterfaceFragment
    }
    propertyId
    alerts {
      ...SmartFlexDeviceAlertInterfaceFragment
    }
    onboardingWizard {
      ...SmartFlexOnboardingWizardFragment
    }
    preferences {
      ...SmartFlexDevicePreferencesInterfaceFragment
    }
    preferenceSetting {
      ...FlexDevicePreferenceSettingInterfaceFragment
    }
    reAuthenticationState {
      ...DeviceReAuthenticationInterfaceFragment
    }
  }
}

{
  "input": UpdateIsChargingDurationCappedInput
}

{
  "data": {
    "updateIsChargingDurationCapped": {
      "id": "abc123",
      "name": "abc123",
      "deviceType": "BATTERIES",
      "provider": "BYD",
      "integrationDeviceId": "abc123",
      "status": SmartFlexDeviceStatusInterface,
      "propertyId": "abc123",
      "alerts": SmartFlexDeviceAlertInterface,
      "onboardingWizard": SmartFlexOnboardingWizard,
      "preferences": SmartFlexDevicePreferencesInterface,
      "preferenceSetting": FlexDevicePreferenceSettingInterface,
      "reAuthenticationState": DeviceReAuthenticationInterface
    }
  }
}

updateOptionsLanguagePreference

Type:UpdateOptionsLanguagePreference

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Update the preferred language from account's options. Used for communications.

The possible errors that can be raised are:

KT-CT-4123: Unauthorized.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (OptionsLanguagePreferenceInput!)

Variables needed to update the language preference for an account.

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

optionsLanguagePreference (OptionsLanguagePreferenceChoices)

The selected language preference.

mutation UpdateOptionsLanguagePreference($input: OptionsLanguagePreferenceInput!) {
  updateOptionsLanguagePreference(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    optionsLanguagePreference
  }
}

{
  "input": OptionsLanguagePreferenceInput
}

{
  "data": {
    "updateOptionsLanguagePreference": {
      "possibleErrors": [PossibleErrorType],
      "optionsLanguagePreference": "ENGLISH"
    }
  }
}

updateUser

Type:UpdateUserMutation

URL:https://api.resiflexeu-kraken.systems/v1/graphql/

Update the account user details of the authenticated user.

Only one name field can be updated per day, other fields can be updated freely. This prevents users from switching accounts to someone else (usually when moving homes). All account changes should be handled by operations or the move out journey. New customers are exempt from this rule for the first 31 days.

This field requires the Authorization header to be set.

The possible errors that can be raised are:

KT-CT-5413: Invalid data.
KT-CT-5414: Invalid data.
KT-CT-1113: Disabled GraphQL field requested.
KT-CT-1111: Unauthorized.
KT-CT-1112: 'Authorization' header not provided.

Arguments

Name Description

input (UpdateUserInput!)

Input fields for updating user.

Return fields

Name Description

possibleErrors ([PossibleErrorType])

Field with the possible errors of the query/mutation.

Deprecated

viewer (AccountUserType)

mutation UpdateUser($input: UpdateUserInput!) {
  updateUser(input: $input) {
    possibleErrors {
      ...PossibleErrorTypeFragment
    }
    viewer {
      ...AccountUserTypeFragment
    }
  }
}

{
  "input": UpdateUserInput
}

{
  "data": {
    "updateUser": {
      "possibleErrors": [PossibleErrorType],
      "viewer": AccountUserType
    }
  }
}

Mutations

API Site

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation

Variables

Response

Arguments

Return fields

Mutation