Skip to main content
The write-back companion to get_gtm_profile. Use it whenever the user states, or you learn, a lasting change to how they go to market — repriced, moved upmarket, sharpened positioning, changed their motion, won a new segment, or a useful note about how they operate. Each section is a living file. In the default replace mode the section evolves — the old version is kept as history, never silently contradicted — so you just write the section’s current state. Nous is the source of truth for the GTM context: write back here instead of keeping a local file.
Not for prospects. This is the user’s OWN business, not a person or company. For facts about a contact, use record; to keep a document on a contact, use save_note.

​
Parameters

​
Returns

The verb reflects what happened — Recorded (new), Updated (evolved an existing section), or Logged to (append mode).

​
When to call it

  • “We just moved upmarket to 200–1000 employees” → section: "ICP", replace
  • “We raised Scale to $149” → section: "Pricing", replace
  • “We now lead with the audit-trail angle” → section: "Positioning", replace
  • A durable operating note → section: "Notes", append

​
Backed by

POST /v2/workspace/facts — the same workspace-facts endpoint get_gtm_profile reads. See the GTM Profile HTTP reference.