SCscipot
pots

The POT's «about» and the themes it comes from

Changed on

What the POT knows in one or two sentences (text, also in GET /pots/{pot_id} and the listing as about), whether the engine wrote it (generated) or the owner did (manual), and the POT's most frequent document themes (at most 15).

The engine keeps a generated text up to date after each ingestion: one cheap yes/no question decides whether new themes deserve a new text. A manual text is never rewritten; suggestion_pending says the POT now has a subject it does not cover.

Themes. Only themes that passed the engine's privacy filter are kept (no person's names, contacts or masked values), but they are the documents' subjects word for word. The API has no role below the workspace key: show them only to whoever manages the POT.

get/pots/{pot_id}/about

Request

Path parameters

pot_idstring uuid required

Response

Successful Response

textstring nullable

None: nothing written yet

source'generated' | 'manual' nullable
updated_atstring date-time nullable
suggestion_pendingboolean

A manual text whose POT has since gained a subject it does not cover: the owner may write it again or go back to the generated one.

languagestring nullable

Changes