---
title: "Report Trail"
method: POST
path: "/user/location/trail"
tags: ["user-location"]
---

# Report Trail

`POST /user/location/trail`

## Request body

- TrailReport
  - `points` TrailPoint[], required
    - `latitude` number, required
    - `longitude` number, required
    - `accuracy_m` number, nullable
    - `speed_mps` number, nullable
    - `recorded_at` string, date-time, required

## Response `200`

Successful Response

- TrailReportResponse
  - `stored` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-22** `750ef040fb57` — 1 warning
  - deleted the `header` request parameter `X-Timezone`
- **2026-09-21** `92653d53d791` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stardrift/apis/fastapi/changes/user/location/trail/post.md)

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/stardrift/apis/fastapi/revisions/ae2c9c9f8e5d?raw)