---
title: "Mark an app tour page seen"
method: POST
path: "/api/user/settings/app-tour"
tags: ["User"]
---

# Mark an app tour page seen

`POST /api/user/settings/app-tour`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/user/settings/app-tour`
- Auth: HTTP bearer

Authenticated. Marks one tour page seen for the session user (#777). Idempotent: a repeat call, including one that loses a unique-constraint race with another device, returns 200 with alreadySeen true and the original completedAt. It does not insert a duplicate row and it is not an error. A userId in the body is ignored. Page key format: ^[a-z][a-z0-9]*(-[a-z0-9]+)*$, length 1-64 (lowercase kebab-case). Canonical auto-start keys (engage-native TOP_LEVEL_PAGES): locker-room, leaderboard, profile, shop, wallet. Other TOUR_PAGES keys today: hq-hub, hq-match, post, scan-qr, search, notifications, lb-team, lb-browse, settings, market-packs, market-collectibles, market-trading, market-wishlist. The server accepts any key matching the pattern; it is not a closed enum. completedAt is ISO-8601 UTC.

## Request body

- object
  - `page` string, required: Tour page key. Lowercase kebab-case, 1-64 characters.

## Response `200`

{ success: true, data: { page, completedAt, alreadySeen, appTour: { seenPages: [{ page, completedAt }] } } }. alreadySeen is false on the inserting call and true when the row already existed. completedAt does not move. seenPages is the full set, oldest completion first.

- object
  - `success` true, required
  - `data` object, required
    - `page` string, required
    - `completedAt` string, date-time, required
    - `alreadySeen` boolean, required
    - `appTour` object, required
      - `seenPages` object[], required
        - `page` string, required
        - `completedAt` string, date-time, required

## Other responses

- `400`: { success: false, error, code: VALIDATION_ERROR }. Bad or missing page, non-object body, or invalid JSON.
- `401`: { success: false, error, code: UNAUTHORIZED }
- `404`: { success: false, error: User not found, code: NOT_FOUND }. No row is written.

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/user/settings/app-tour/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
