API Reference
Suggest rewrite-level adjustments (rename section, reword topic, update intro) after a brief-level edit like contentType or search intent description
POST
header
AuthorizationBearer <token>Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
briefId*stringBrief ID
domainId*stringDomain ID
application/json- body
trigger*stringWhich brief-level edit triggered the suggestion request
Value in
"content_type_change""intent_change"previousValue*stringValue before the user edited it
newValue*stringCurrent value after the edit
Adjustment suggestion
application/json- response
trigger*stringTrigger that produced this suggestion
Value in
"content_type_change""intent_change"actions*array<>Proposed rewrite actions
rationale*stringOne-sentence explanation for the UI
curl -X POST 'https://api.getmint.ai/api/domains/string/content-briefs/string/document/suggest-adjustments' \ -H 'Content-Type: application/json' \ -d '{ "trigger": "content_type_change", "previousValue": "how_to", "newValue": "guide"}'{ "trigger": "content_type_change", "actions": [ { "type": "rename_section", "sectionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "topicIndex": 0, "newTitle": "Finding your fit", "newTopic": "how to measure foot size at home", "newInstructions": "Open with a relatable scenario about buying the wrong shoes." } ], "rationale": "Switching to a guide means the comparison-table section should be reworded."}