GenesisForums
Documentation navigation

Novel and thread resolution

How Genesis finds a novel, reuses its discussion, and handles missing titles.

Title matching

Genesis first looks for an exact, case-insensitive title match among published Genesis novels, then among approved partner-sourced Forum novels. Send the canonical public title whenever possible; aliases and approximate matching are not guaranteed.

Canonical discussion

Each novel has one canonical discussion thread. Genesis reuses it when it exists and creates it when required. The API response contains the selected threadId and URL.

Do not create one ingestion event to represent both a thread and a comment. The endpoint manages the thread as part of the comment operation.

Missing novels

If the integration has Create novels capability, Genesis may create a partner-sourced novel record and its discussion. Otherwise the request returns novel_not_found.

Partner-sourced novels remain identifiable and can require approval before appearing broadly. Creating novels should be requested only when the partner has reliable canonical metadata.

Chapter context

chapterNumber is optional metadata on the imported post. It provides context in the discussion but does not create, publish, or unlock a Genesis chapter. Omit it for novel-level comments.