Improve Desk Email
POST /desk/email-improve
POST
/desk/email-improve
Rewrite a draft, targeting the subscores it is failing.
Unlike /desk/email-score this one has no heuristic fallback: it is a
model call or nothing. 400 when the org’s ai_briefs switch is off, 502
when the model could not answer.
Authorizations
Parameters
Header Parameters
Request Body required
A draft to rewrite. The rewrite targets its FAILING subscores.
object
body
required
string
subject
string
Responses
200
Successful Response
object
data
required
An open envelope for one desk object.
Open on purpose - see the module docstring. A rebuilder gets every field the desk returns, including ones added after this contract version.
object
key
additional properties
any
pagination
Any of:
object
has_next
required
Whether there are more pages
boolean
limit
required
Items per page
integer
notes
Any of:
Array<string>
null
page
required
Current page number (1-indexed)
integer
total
required
Total number of items
integer
null
422
Validation Error
object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string