Record a choice for the new location

POST/v1/organizations/{organizationId}/linked-jobs/{jobId}/intentions

Records one choice to apply when the location moves to your organization. The kind says what it is: assignTariff (the ref is one of your own tariffs), setSiteAccess (the ref is open, private or paid) or setDeviceSetting (the ref is the setting's name and value its value). Nothing electrical can be chosen.

Recording the same choice again returns the existing one with 200; a changed device value replaces the old one while it is still recorded.

You need the permission that already guards the thing you choose, in your organization's own project: pricing.tariff.manage for a tariff, authorization.access_policy.manage for who may charge, ocpp.settings.update for a device setting. A choice that is not valid is a 422 with a short fixed sentence that never repeats what you sent.

Authorization

Authorizationheader · stringrequired
Bearer <token>, with an ID token from a console sign-in or an API key (flw_ak_…). How authentication works

Parameters

organizationIdpath · uuidrequired
Your organization, the customer.
jobIdpath · uuidrequired
The job.

Request body

application/json · required

kindenumrequired
One ofassignTariffsetSiteAccesssetDeviceSetting
refstringrequired
valuestringnullable

Responses

200 OK

The same choice was already recorded.

createdAtdate-timerequired
iduuidrequired
kindenumrequired
One ofassignTariffsetSiteAccesssetDeviceSetting
refstringrequired
stateenumrequired
One ofrecordedappliedskippedfailed
skippedReasonstringnullable
valuestringnullable

Headers

RateLimit-Limitheader · string
RateLimit-Remainingheader · string
RateLimit-Resetheader · string

201 Created

The choice was recorded.

createdAtdate-timerequired
iduuidrequired
kindenumrequired
One ofassignTariffsetSiteAccesssetDeviceSetting
refstringrequired
stateenumrequired
One ofrecordedappliedskippedfailed
skippedReasonstringnullable
valuestringnullable

Headers

RateLimit-Limitheader · string
RateLimit-Remainingheader · string
RateLimit-Resetheader · string

401 Unauthorized

Your token is missing, has expired or isn't valid. Sign in again, or use a valid API key.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

403 Forbidden

You are a member of the organization, but you don't hold the permission for this kind of choice in its project.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

404 Not found

No such linked job for your organization, or you are not a member of it.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

409 Conflict

The location has already moved (handoverFinished).

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

422 Unprocessable

The choice is not one your organization may make (invalidRequest).

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

429 Too many requests

Too many requests. Wait the number of seconds in Retry-After, then try again.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

Headers

Retry-Afterheader · string
X-RateLimit-Afterheader · string

500 Internal error

Something went wrong on our side. Try again, and if it keeps happening, contact support with the response's requestId.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

503 Unavailable

The tariff could not be checked just now (tryAgainLater). Nothing was recorded.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyaccountsCollidealreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableidentityPlatformUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlastSignInlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelStockLimitlabelHeldElsewherelabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInClassMismatchsignInInUsesignInUnverifiedsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
messagestringrequired
A description for people. Its wording may change, so don't parse it.
requestIdstring
This request's id, the same as the x-request-id response header. Quote it when you contact support.

Headers

Retry-Afterheader · string

RequestcURL
bashcurl -X POST "$API/organizations/$ORGANIZATION_ID/linked-jobs/$JOB_ID/intentions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "assignTariff",
  "ref": "string"
}'

Response

200 OK

json

{
  "createdAt": "2026-09-29T08:14:02Z",
  "id": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12",
  "kind": "assignTariff",
  "ref": "string",
  "skippedReason": "string",
  "state": "recorded",
  "value": "300"
}

201 Created

json

{
  "createdAt": "2026-09-29T08:14:02Z",
  "id": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12",
  "kind": "assignTariff",
  "ref": "string",
  "skippedReason": "string",
  "state": "recorded",
  "value": "300"
}

401 Unauthorized

json

{
  "error": "unauthorized",
  "message": "Your token is missing, has expired or isn't valid",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

403 Forbidden

json

{
  "error": "forbidden",
  "message": "You are a member of the organization, but you don't hold the permission for this kind of choice in its project",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

404 Not found

json

{
  "error": "notFound",
  "message": "No such linked job for your organization, or you are not a member of it",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

409 Conflict

json

{
  "error": "conflict",
  "message": "The location has already moved (handoverFinished)",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

422 Unprocessable

json

{
  "error": "stepUpRequired",
  "message": "The choice is not one your organization may make (invalidRequest)",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

429 Too many requests

json

{
  "error": "rateLimited",
  "message": "Too many requests",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

500 Internal error

json

{
  "error": "internalError",
  "message": "Something went wrong on our side",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

503 Unavailable

json

{
  "error": "serviceUnavailable",
  "message": "The tariff could not be checked just now (tryAgainLater)",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}