Approve a client-initiated connection request

POST/v1/connections/authorize/approve

Idempotency-Key required

Called by Flowion's sign-in page when the person allows the app. Send the same session and the same nonce and CSRF headers the preview was given, the requestId, the parameters unchanged, the home the person chose and the scopes they approve (every required scope, and only requested ones). An Idempotency-Key header is required.

Flowion first checks the stored request: it must be this person's, for this app, unexpired, unused, with the browser values and parameters unchanged. Nothing is issued otherwise. It then creates the connection and a single-use code, and returns redirectTo: navigate the top-level window there straight away and never log or store it. A retry with the same key returns the same address until the app redeems the code.

Requires connections.connection.manage on the chosen home.

Authorization

Authorizationheader · stringrequired
Bearer flw_ak_… with an API key, or DPoP <token> with a signed-in person's access token and a DPoP proof header. How authentication works

Parameters

X-Flowion-Grant-Nonceheader · stringrequired
X-Flowion-Csrfheader · stringrequired
Idempotency-Keyheader · stringrequired

Request body

application/json · required

clientIdstringrequired
codeChallengestringrequired
codeChallengeMethodstringrequired
organizationIduuidrequired
redirectUristringrequired
requestIduuidrequired
scopesarray of stringrequired
statestringrequired
labelstringnullable

Responses

200 OK

Access is granted. Send the browser to redirectTo now.

redirectTostringrequired

Headers

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

400 Bad request

requestInvalid: no such request, another person's, or the parameters differ from the preview. Also a malformed body or a missing Idempotency-Key.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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.

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 ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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

Not a signed-in browser session, the browser headers don't match, or the person doesn't own that home.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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 app or home, or it isn't available to this person.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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

requestConsumed, noEligibleOrganization, requiredScopeMissing, or idempotencyKeyConflict (the code was already redeemed).

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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.

410 Gone

requestExpired: the request is older than ten minutes. Start again from the app.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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 ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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 ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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

Connections are temporarily unavailable. Try again shortly.

errorenumrequired
A stable code for the error. Switch on this value: it doesn't change between releases.
One ofstepUpRequiredcoolingOffauthUnavailableavatarTooLargebelowPrivilegedMinimumtryAgainLaterhandoverFinishedintentionNotRemovableaddressAmbiguousaddressNotFoundgeocodingUnavailableinvalidCoordinateResolutionpublicCatalogueUnavailableaccessRevokedjobNotOpenvendorRateLimitedvendorUnavailablezaptecUnavailableincompleteMappinginstallationClaimedconsentInvalidrequestConflictstaleRevisionaccountHasOpenBalanceaccountNotReadyalreadyStartedalreadyHandedOvernotAvailablenotOnsystemConfirmedambiguousIdTokenambiguousReservationAddressassetServiceUnavailablelocationCoordinatesRequiredforecastTimeOutsideCoverageweatherServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableadditionsNotAllowedauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyspeechRateLimitedspeechNotReadyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnecteddismissedForSessionduplicateduplicateSlugdetachFirsteaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownfinishAccountSetupforbiddenhandoverNotReadyhandoverBegunhasChildCircuitshasInvertersholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinverterBindingConflictinvalidRequestinvalidRegistrationliveUpdatesUnavailableinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredpricingUnavailableprojectsHaveNoDefaultrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectnotAnOperationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitlednoEligibleOrganizationrequestConsumedrequestExpiredrequestInvalidrequiredScopeMissingassigneeCannotReadJobnotFoundlabelMistypedlabelNotFoundlabelRetiredlabelLinkedElsewhereoutletHasLabelsandboxOutletnotOfferednotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehiclenothingToOffernotAdminOrOwnerocppUnavailableorganizationNotEmptyorganizationNumberMismatchownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.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.stalepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablepaymentModeUnknowndeviceAttestationRequiredlimitExceededattestationRejectedpaymentsNotEnabledamountOutOfRangecarNotPluggedInchargerOfflinepriceUnavailableorganizationNotTestEligiblequoteExpiredquoteUsedphaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedrecentSignInRequiredcardHeldElsewherecardNotReadablecardUidChangescardsNotEnabledcardsUnavailablelearnAlreadyOpenlearnAmbiguouslearnExpiredlearnNotOfferedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerTermsUrlInvalidsellerUnavailablestaleCircuitserviceUnavailablesessionEndedsessionServiceUnavailablestationOfflinestationsNotDeprovisionedsigningSecretTooShortsignInRequiredtooManyOpenSessionssiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpentrackingUnavailableunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinhomeVehiclePreferencesChangedhomeLimithomeHasMembersinvitationNotFoundhomeNotReadyinvalidPriceinvalidPriceAreagridFeeCurrencyUnsupportedpriceAreaRequirednotAvailableForHomepublicLocationlocationStepRequired
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/connections/authorize/approve" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Flowion-Grant-Nonce: {X-Flowion-Grant-Nonce}" \
  -H "X-Flowion-Csrf: {X-Flowion-Csrf}" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "clientId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12",
  "codeChallenge": "string",
  "codeChallengeMethod": "string",
  "organizationId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12",
  "redirectUri": "string",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12",
  "scopes": [
    "string"
  ],
  "state": "string"
}'

Response

200 OK

json

{
  "redirectTo": "string"
}

400 Bad request

json

{
  "error": "badRequest",
  "message": "requestInvalid: no such request, another person's, or the parameters differ from the preview",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

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": "Not a signed-in browser session, the browser headers don't match, or the person doesn't own that home",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

404 Not found

json

{
  "error": "notFound",
  "message": "No such app or home, or it isn't available to this person",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

409 Conflict

json

{
  "error": "conflict",
  "message": "requestConsumed, noEligibleOrganization, requiredScopeMissing, or idempotencyKeyConflict (the code was already redeemed)",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}

410 Gone

json

{
  "error": "stepUpRequired",
  "message": "requestExpired: the request is older than ten minutes",
  "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": "Connections are temporarily unavailable",
  "requestId": "3f7c2a90-1b4e-4d6f-8a21-9c0e5b7d4f12"
}