Create an anonymous knowledge base visitor

Changed on Oct 28, 2026

Called by the public knowledge base after page paint or an explicit interaction, never by its HTML/HEAD renderer. No bearer token or cookie is required. The Origin must be an approved HTTPS host for this desk, and the current publication must still be enabled. Rate limits apply before visitor draws and interaction writes; no raw IP, user-agent, referrer or search text is stored in analytics. Minted lazily through the Entropy service, at most 600 per network address per hour across desks. The server stores only its hash for 30 days. Cache-Control is no-store; keep it locally per desk and handle storage failures without blocking content.

post/hd/desks/{desk_id}/kb/visitor

Request

Base URL
https://api.sparkvault.com/v1
Auth
none required
TypeScript
https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/hd/desks/:desk_id/kb/visitor/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

desk_idstring required

Headers

Originstring uri required

The actual HTTPS origin hosting this desk; credentials, paths and nondefault ports are refused.

Request body

release_idstring

The immutable release ID embedded in the page.

Response

The saved result.

Changes

Oct 28, 2026a9a10e328ba5 Revision changes
- breaking
  added the new path request parameter desk_id
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
Oct 28, 202656d7c265a77a Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status

Operation history (3 revisions)