LogoLogo
Insights
  • Introduction
  • A standard integration
  • FAQ
    • FAQ
      • Integration (FAQ)
      • Detections (FAQ)
      • Data interface (FAQ)
      • Security, Privacy and Terms of Service (FAQ)
      • Journeys and Insights (FAQ)
  • SDK
    • Getting Started
      • Android Quick Start
        • 1. Android Checklist
        • 2. Including the SDK
        • 3. Configuration
          • Sample Notification
        • 4. Initialization
        • 5. Starting Detections
        • 6. SDK Status Updates
        • 7. Permissions
        • 8. What's Next
      • iOS Quick Start
        • 1. iOS Checklist
        • 2. Installation
          • Installation with CocoaPods
          • Installation with Carthage
          • Manual Installation
        • 3. Configuration
          • Using Integration Guide
          • Manual Configuration
        • 4. Usage
        • 5. Tips and Guidelines
        • 6. What's Next
      • React Native Quick Start
        • 1. React Native Checklist
        • 2. Installation
        • 3. Configuration
        • 4. Initialization
        • 5. Usage
        • 6. What's Next
    • Appendix
      • Android
        • Android 10 Update Behavior
        • Android Battery Optimization
        • External SDK Dependencies
        • Manifest Permissions
        • Notification Management
      • iOS
        • App Store Privacy Section
        • App Store Release
        • iOS 13 permission changes
        • M1 Simulator Support
        • Swift Support
      • Control Sending Data
      • Controlled Detections
        • Automatic Detections
        • Automatic Detections with Forced Trips
        • Controlled Trips Only
        • Checking Trip Status
      • Custom User Metadata
      • Detecting Vehicle Crashes
      • Migration Guide
        • Android
        • iOS
      • React Native
      • SDK Initialization
      • User Credentials
      • User Linking
      • Xamarin
    • API Reference
      • Android
        • VehicleCrashDetection
          • VehicleCrashEvent
          • VehicleCrashListener
          • CrashCallback
        • InitState
        • MetaUserLinker
        • MetaUserLinkerAsync
        • MetaUserLinkerCallback
        • OnInitCallback
          • InitIssue
        • OnSdkStatusUpdateHandler
        • OnStartFinishedHandler
        • PoiAddress
        • PoiLocation
        • PointOfInterest
        • PoiPlace
        • ResetCallback
          • ResetFailureReason
        • SdkConfig
          • Builder
        • SdkException
        • SdkStatus
          • LocationSetting
          • Quota Status
          • StartStatus
        • Sentiance
        • SubmitDetectionsCallback
        • StationaryInfo
        • Token
        • TokenResultCallback
        • Trip
          • StartTripCallback
          • StopTripCallback
          • TransportMode
          • TripTimeoutListener
          • TripType
        • TripInfo
        • TripProfile
          • HardEvent
          • TransportSegment
          • VehicleMode
        • TripProfileConfig
          • Builder
        • TripProfileListener
        • UserActivity
        • UserActivityListener
        • UserActivityType
      • iOS
        • MetaUserLinker
        • SENTSDK
          • SENTSDKStatus
          • SENTPublicDefinitions
        • SENTConfig
        • SENTTripProcessingTripProfile
          • SENTTripProcessingTransportSegment
          • SENTTripProcessingHardEvent
          • SENTTripProcessingVehicleMode
        • SENTVehicleCrashEvent
      • React Native
    • Battery Optimization
    • How To
      • Check the Location Permissions
    • Troubleshooting
      • Android
      • iOS
        • Bundle format unrecognized, invalid, or unsuitable
        • Error: Undefined symbols for architecture arm64
    • Changelog
      • Android
      • iOS
  • Important topics
    • Authentication and Authorization
    • User linking
    • PlayStore Location Access Review
    • Privacy Report & Dashboard
    • Vehicle Crash Detection
  • Library
    • Events
    • Moments
    • Segments
    • Glossary
  • Backend
    • GraphQL
    • REST API Reference
      • Error Codes (REST API)
    • Offloads
    • Data Reference
      • Data Reference A-B
      • Data Reference C-G
      • Data Reference H-L
      • Data Reference M-P
      • Data Reference Q-T
      • Data Reference U-Z
  • Data Explorer
    • Data Explorer
      • Global (EU)
      • US
      • Australia
  • Guide
    • Firehose
    • Verifying your integration
    • SDK Standard License
    • Journeys License
    • Journeys Application
    • Journeys Privacy Policy
    • Technical & Organizational Measures
Powered by GitBook
On this page
  • CANNOT_LINK_EXISTING_PERSON_TO_OTHER_PERSON
  • INSTALL_NOT_FOUND
  • INSTALL_DOES_NOT_BELONG_TO_APP
  • INSTALL_DISABLED
  • INSTALL_DELETED
  • INSTALL_DEACTIVATED
  • INSTALL_LINKED_TO_OTHER_USER
  • MULTIPLE_INSTALLS_ACTIVE
  • USERLINKING_NOT_CONFIGURED
  • USER_DOES_NOT_BELONG_TO_APP
  • USER_NOT_FOUND
  1. Backend
  2. REST API Reference

Error Codes (REST API)

A description of the error codes you might encounter while working with our REST API.

PreviousREST API ReferenceNextOffloads

Last updated 1 year ago

This document refers to deprecated parts of the platform and has been left intact to help customers with legacy integrations. In order to access the latest platform features and documentation, please go to https://docs.sentiance.com.

CANNOT_LINK_EXISTING_PERSON_TO_OTHER_PERSON

This error code will be returned when a User-Linking REST API request tries to link an active install_id to an existing external_id which already has a linked install_id.

This primarily happens when legacy users, who were first created before user linking was introduced in the app, are switching to a new device. Because they were created before user linking was introduced, they got 'hardlinked' to the initial install id. As a result, they cannot be linked to a new device. To resolve this, create a new user under a different Sentiance id.

INSTALL_NOT_FOUND

This error code will be returned when the given install_id cannot be found in a User-Linking REST API request.

INSTALL_DOES_NOT_BELONG_TO_APP

This error code will be returned when the given install_id's app_id doesn't match the given app_id in a User-Linking REST API request.

Make sure you've used the right app_id. Most clients use multiple environments (production, staging, development, ...). Make sure you are using the app_id belonging to the right environment. These are not interchangeable.

INSTALL_DISABLED

This error code will be returned when the given install_id is found to be disabled by the platform in a User-Linking REST API request.

INSTALL_DELETED

This error code will be returned when the given install_id is found to be deleted by the platform in a User-Linking REST API request.

INSTALL_DEACTIVATED

This error code will be returned when the given install_id is already linked and is no longer active in a User-Linking REST API request.

INSTALL_LINKED_TO_OTHER_USER

This error code will be returned when the given install_id is found to have a linked external_id while this linked external_id doesn't match the given external_id in a User-Linking REST API request.

MULTIPLE_INSTALLS_ACTIVE

This error code will be returned when there are two or more active install_ids found in the platform by the given external_id in a User-Linking REST API request.

USERLINKING_NOT_CONFIGURED

This error code will be returned when the app is found to not have user-linking enabled in a User-Linking REST API request.

For most apps, User Linking will be turned on by default. If this is not the case for your app, please reach out to Support and they'll set things up for you.

USER_DOES_NOT_BELONG_TO_APP

This error code will be returned when the app_id of the given users doesn't match the given app_id in a Custom-Event REST API request.

USER_NOT_FOUND

This error code will be returned when any of the given users cannot be found in the platform in a Custom-Event REST API request.

Make sure you've used the right Sentiance id. Most of our REST API queries expect to receive the Sentiance ID, not your external ID.

CANNOT_LINK_EXISTING_PERSON_TO_OTHER_PERSON
INSTALL_NOT_FOUND
INSTALL_DOES_NOT_BELONG_TO_APP
INSTALL_DISABLED
INSTALL_DELETED
INSTALL_DEACTIVATED
INSTALL_LINKED_TO_OTHER_USER
MULTIPLE_INSTALLS_ACTIVE
USERLINKING_NOT_CONFIGURED
USER_DOES_NOT_BELONG_TO_APP
USER_NOT_FOUND