---
title: "Silent background location update (fire-and-forget)"
method: PATCH
path: "/api/v1/users/me/location"
tags: ["users"]
---

# Silent background location update (fire-and-forget)

`PATCH /api/v1/users/me/location`

## Request

- Base URL: `https://yondry.app` (the document declares no server; this is the origin it was published from)
- URL: `https://yondry.app/api/v1/users/me/location`
- Auth: HTTP bearer

Record the user's current device location for planning purposes.

Returns 204 No Content — the mobile client does not need to await a body.
The last_location fields are used by resolve_planning_location as a
secondary planning origin when the user is far from home.

Requires DEVICE_LOCATION consent (EXPLICIT tier). Returns 403 if not
granted — the mobile client should guide the user to the privacy settings.

## Request body

- UserUpdateLocation: PATCH /users/me/location — silent background location update. Returns 204 No Content (fire-and-forget from mobile).
  - `last_location_lat` number, required
  - `last_location_lng` number, required

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yondry/apis/yondry-api.md) · [All operations](https://skmtc.dev/yondry/apis/yondry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yondry/apis/yondry-api/revisions/d2c213cea95b?raw)