/v1/message-drafts/{id}Change message-drafts id
Edit a saved draft. Legacy partial edits take recipient, subject or body and only accept draft status. Inbox email edits provide expectedUpdatedAt (the row's current updatedAt), recipient, subject, body and accountIdentifier (empty to choose a mailbox later). Versioned edits are restricted to the caller's own email drafts, reject stale revisions, and reopen an approved-but-unsent draft for review. Queued or cancelled drafts cannot be edited. The chosen mailbox must be in get_comms_senders. Saving sends nothing.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredan RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
Responses
the action's answer
{
"data": {
"aiFlaggedFigures": [
"string"
],
"aiGenerated": true,
"aiIntent": "string",
"aiModel": "string",
"aiPromptHash": "string",
"approvedAt": "2026-01-01T00:00:00Z",
"approvedByUserId": 1,
"body": "string",
"cancellationReason": "string",
"cancelledAt": "2026-01-01T00:00:00Z",
"channel": "string",
"createdAt": "2026-01-01T00:00:00Z",
"createdByKind": "string",
"createdByUserId": 1,
"detail": {},
"entityId": 1,
"entityKind": "string",
"id": 1,
"recipient": "string",
"recordDefinitionKey": "string",
"recordRowId": "",
"ruleId": 1,
"status": "string",
"subject": "string",
"templateId": 1,
"updatedAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}