Update Settings

Update your account preferences by sending only the fields you want to change. Omitted fields are left unchanged. You must include a valid Bearer token.

Request

PUT /user-settings

Authorization: Bearer <token>
Content-Type: application/json

Enable or disable trip sharing by default when starting a ride.

boolean

Hide or reveal your phone number to drivers.

string

Emergency contact phone number or name (up to 40 characters).

string

Default payment method (e.g. upi, card).

boolean

Enable or disable automatic tipping after rides.

boolean

Enable or disable email invoices after rides.

string

Map rendering style (e.g. standard, satellite).

boolean

Whether route planning should avoid toll roads.

boolean

Whether route planning should avoid highways.

BCP 47 language code for navigation voice prompts (e.g. en, hi).

string

Preferred vehicle category for ride requests (e.g. mini, sedan, suv).

string

Air conditioning preference (e.g. any, ac, non_ac).

boolean

Prefer a quiet ride with minimal conversation.

boolean

Submit or retract an account deletion request.

Only the fields you include in the request body are updated. All other settings remain at their current values. You can send a request body with a single field to update just that preference.

Response

The response returns the full updated settings object. See Get Settings for the complete field reference.

integer

Unique ID of the settings record.

integer

ID of the user these settings belong to.

Updated trip sharing default.

boolean

Updated phone number visibility preference.

string

Updated emergency contact.

string

Updated default payment method.

boolean

Updated auto-tip preference.

boolean

Updated invoice email preference.

string

Updated map style.

boolean

Updated toll avoidance preference.

boolean

Updated highway avoidance preference.

Updated navigation voice language.

string

Updated preferred vehicle type.

string

Updated AC preference.

boolean

Updated quiet ride preference.

boolean

Updated account deletion request status.

string

ISO 8601 timestamp of record creation.

string

ISO 8601 timestamp of this update.

Example

curl -X PUT http://localhost:8080/user-settings \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "quietRide": true,
    "defaultPaymentMethod": "card",
    "avoidTolls": true
  }'

{
  "id": 3,
  "userId": 7,
  "tripSharingDefault": true,
  "hidePhoneNumber": false,
  "emergencyContact": "+91 98765 43210",
  "defaultPaymentMethod": "card",
  "autoTipEnabled": false,
  "invoiceEmailEnabled": true,
  "mapStyle": "standard",
  "avoidTolls": true,
  "avoidHighways": false,
  "navigationVoiceLanguage": "en",
  "preferredVehicleType": "mini",
  "acPreference": "any",
  "quietRide": true,
  "deleteAccountRequested": false,
  "createdAt": "2026-01-15T08:00:00Z",
  "updatedAt": "2026-04-02T09:45:00Z"
}

Authentication

Rides

Payments

Notifications & Settings

Request

Response

Example

​Request

​Response

​Example

Request

Response

Example