rest api rewrite
the rewrite endpoint changes selected text using the chosen voice profile. it is for targeted repairs, not for replacing every sentence with a generic ai draft.
quick answer
rewrite the smallest section that actually needs help, then let the user approve it.
use this for
- repairing a flagged sentence from another tool
- building a backend workflow that improves drafts
- helping an agent preserve voice while editing
steps
- send a bearer key with the `rewrite` scope.
- send the text that should change, not unrelated context.
- send the profile or resolved brand.
- include the goal if the workflow has one.
- show the rewrite as a suggestion before replacing user text.
details to know
- rewrites should respect the voice profile, samples, accepted lessons, and document format.
- rewrite is separate from analyze so agents can inspect before changing text.
- accepted rewrites may contribute to learning signals in the app flow.
limits and edge cases
- do not auto-accept rewrites in user-owned documents unless the user asked for that.
- a rewrite can still be wrong if the profile is weak or the brand is unresolved.
ready to use the product instead of reading about it?
open app