Housestyle

List voice profiles

Lists the voice profiles on the signed-in user's Housestyle account, with each profile's registers and how much writing each register holds. Reads only; changes nothing.

Get a voice profile

Returns one profile: its registers with their sufficiency state, a count of the never-say rules on it, and the marker weights used when scoring. Does not return the writing the profile was built from. Reads only; changes nothing.

Score a draft

Scores a piece of text against one register of the user's profile and returns a headline out of 100, a marker-by-marker comparison, and any never-say matches. The text is not stored: it is sent to Housestyle to be measured and discarded. Use file_evidence to keep a result.

Check the never-say list

Checks text against the user's never-say list only, and returns each match with its position. Faster and narrower than score_draft. The text is not stored.

Rewrite in the user's voice

Suggests wording changes that bring a draft closer to how the user writes, and returns the rewritten text with a list of each change and the finding that prompted it. Suggestions only: nothing is saved and the user's stored profile is unchanged.

Create a voice profile

Creates a voice profile on the user's Housestyle account, with a starting set of registers. If a profile already exists it is returned unchanged rather than a second one being created.

Add writing to a profile

Sends the supplied writing to the user's Housestyle account and stores it as profile evidence, under the named register. It is stored until the user deletes it, and it is never returned by this tool. Returns only the register's updated word and document counts.

Set the active profile

Marks one profile as the user's active profile, so later calls that omit a profile use it. Changes which profile is active and nothing else.

Record edit feedback

Records which suggested changes the user accepted and which they rejected, and adjusts the weight of the markers involved so future scores reflect what they care about. Stores the decisions, not the text.

File a scored draft as evidence

Stores a draft and its score on the user's Housestyle account as a permanent record, with any never-say matches attached. Available on Teams accounts. Returns a reference to the stored record.

Delete a voice profile

Permanently deletes a profile, every piece of writing stored under it, and everything derived from it. This cannot be undone. Requires the confirmation phrase to be supplied exactly.