Report what a page shows, for the app map
Sent by the SDK when bootstrap says learnPages: headings, navigation, buttons, tabs, same-site links and form-field labels, names only. 202. Refused (403 app_map_off) when the expert does not learn an app map. Like the events beacon, the key may come as ?key= or a body key, with a text/plain body.
A publishable key (Authorization: Bearer rydhm_pk_…), from one of the key’s allowed websites: the Origin header must be on its list. Never a secret API key (401 secret_key_not_allowed). Rate limited per visitor and per key.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
The page’s path; ids are generalised by the server (/projects/42 → /projects/*).
The publishable key, when sent as a beacon (text/plain body; also accepted as ?key=).
Teach mode: the teach token (rydhm_pv_…). Not throttled; refused (403 teach_token_invalid) when the token or its session is no longer valid.
Teach mode only: the screen’s own words, one line each (# Heading, [Button], plain text of at most 300 characters). Checked again with the app map’s privacy filters; at most 3000 characters are kept, and on a record’s page only headings and actions.
Response
Teach mode: the screens this teach session has learned so far.