Settings
bearerAuthAuthorizationBearer <JWT>Einstellungen
curl -X GET 'https://example.com/api/v1/settings'bearerAuthAuthorizationBearer <JWT>application/json- body
[key: string]?anyEinstellungen aktualisiert
curl -X PUT 'https://example.com/api/v1/settings' \ -H 'Content-Type: application/json' \ -d '{}'Returns the signed-in user's profile and personal preferences, including distanceUnit (km or mi), dateFormat (EU or US), speedUnit (kmh or mph), and timeFormat (12h or 24h). Defaults are km, EU, kmh, and 24h.
bearerAuthAuthorizationBearer <JWT>User profile and settings
application/json- response
user?settings?User preferences. Unspecified distanceUnit defaults to km.
curl -X GET 'https://example.com/api/v1/users/me/settings'{ "user": {}, "settings": { "mapStyle": "osm", "distanceUnit": "km", "dateFormat": "EU", "speedUnit": "kmh", "timeFormat": "12h", "gravatarEnabled": true, "gravatarAvailable": true, "monthlyReportEnabled": true, "monthlyReportAvailable": true, "mapMatchingEnabled": true, "mapMatchingAvailable": true, "aiClassificationEnabled": false, "aiClassificationAvailable": true, "aiClassificationProvider": "claude" }}Updates the signed-in user's personal preferences. Set distanceUnit to km or mi, dateFormat to EU or US, speedUnit to kmh or mph, and timeFormat to 12h or 24h. Stored trip distances, timestamps, and speeds are not modified.
bearerAuthAuthorizationBearer <JWT>application/json- body
distanceUnit?stringPreferred display unit for distances.
"km""mi"dateFormat?stringPreferred date display format (EU DD.MM.YYYY; US MM/DD/YYYY).
"EU""US"speedUnit?stringPreferred speed display unit (km/h or mph).
"kmh""mph"timeFormat?stringPreferred clock format (12-hour AM/PM or 24-hour).
"12h""24h"mapStyle?stringWeb map style – osm = the server's map default, light/dark = OpenFreeMap like in the Android app, auto = light or dark following the color scheme.
"osm""light""dark""auto"Updated personal settings
application/json- response
User preferences. Unspecified distanceUnit defaults to km.
mapStyle?stringWeb map style – osm = the server's map default, light/dark = OpenFreeMap like in the Android app, auto = light or dark following the color scheme.
"osm""osm""light""dark""auto"distanceUnit?stringPreferred distance display unit. Stored trip distances remain in kilometers.
"km""km""mi"dateFormat?stringPreferred date display format. Does not change stored timestamps or API ISO dates.
"EU""EU""US"speedUnit?stringPreferred speed display unit (km/h or mph). Stored measurements are unchanged.
"kmh""kmh""mph"timeFormat?stringPreferred clock display format. Stored timestamps and API ISO dates are unchanged.
"24h""12h""24h"gravatarEnabled?booleanShow the user's Gravatar (looked up by the hashed e-mail address) as profile picture in web and app. Can be changed via PATCH.
truegravatarAvailable?booleanFalse when the instance disables Gravatar (environment variable GRAVATAR_ENABLED=false); clients must not load Gravatar images then.
monthlyReportEnabled?booleanReceive the monthly report by e-mail on the first of each month. Can be changed via PATCH.
truemonthlyReportAvailable?booleanFalse when the server has no SMTP configuration; the monthly report is not sent then.
mapMatchingEnabled?booleanUse map matching: trips are snapped to the road network automatically after upload (POST /tracking/stop, GPX import), and clients show the matched road route (GET /trips/{id}/matched-route) instead of the GPS line. When false, no automatic matching and clients show only the GPS route; distances already applied stay. Only takes effect while mapMatchingAvailable is true. Can be changed via PATCH.
truemapMatchingAvailable?booleanTrue when an administrator has set up a map matching service (Valhalla, OSRM or Dawarich Atlas).
aiClassificationEnabled?booleanLet the AI provider suggest the trip type (business/private/commute). Opt-in, because addresses, times and recent classifications are sent to the provider. Can be changed via PATCH.
falseaiClassificationAvailable?booleanTrue when the feature aiClassification is on and an administrator has set up an AI provider.
aiClassificationProvider?|Active AI provider, shown so users know where their data goes.
"claude""openai""ollama"null[key: string]?anycurl -X PATCH 'https://example.com/api/v1/users/me/settings' \ -H 'Content-Type: application/json' \ -d '{ "distanceUnit": "mi", "dateFormat": "US", "speedUnit": "mph", "timeFormat": "12h"}'{ "mapStyle": "osm", "distanceUnit": "km", "dateFormat": "EU", "speedUnit": "kmh", "timeFormat": "12h", "gravatarEnabled": true, "gravatarAvailable": true, "monthlyReportEnabled": true, "monthlyReportAvailable": true, "mapMatchingEnabled": true, "mapMatchingAvailable": true, "aiClassificationEnabled": false, "aiClassificationAvailable": true, "aiClassificationProvider": "claude"}