What this endpoint does

Creates or updates an analyst note in the Recorded Future platform. To create a new note, omit note_id; to update an existing note, include its doc:XXXXXX ID. The attributes object requires a non-empty title, non-empty text, and at least one entity in either note_entities or context_entities (the spec does not mark entities as required, but the API enforces this). Entity IDs use RF format strings (e.g., ip:8.8.8.8, idn:example.com). Before publishing, use Analyst Notes: Preview to validate entity detection. For valid topic codes see Analyst Notes: Available Topics. For the full attributes schema see Analyst Notes: Note Attributes.

Response data

Returns the published note's ID on success — use this ID for subsequent lookups, attachment downloads, or deletion. The note is immediately visible in the Recorded Future portal and via the API after a successful publish.