v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-06521370.6 KB
val

Look up the identity of the viewer of an app-authenticated (intranet) val, given the X-Val-Town-User header value that Fastify forwarded to the val. Authenticated with the val's own API token (bearer auth). The projectId inside the signed header must match the caller's own project.

get/v3/val/viewer

Headers

x-val-town-userstring required

The signed X-Val-Town-User header value Fastify forwarded to the val.

Response

Public identity of the viewer derived from a verified X-Val-Town-User header. Only safe, public profile fields are returned — no email or tier.

idstring uuid required

The viewer's user id

type'user' | 'org' nullable required

Whether the viewer is a user or an organization

usernamestring nullable required

The viewer's handle, without the @ symbol

biostring nullable required

The viewer's bio, if any

profileImageUrlstring uri nullable required

URL to the viewer's profile image, if any

urlstring uri required

The viewer's profile URL on val.town