/v1/message-drafts/{id}/approveApprove a draft
Record approval of a draft, stamping who and when. APPROVAL IS NOT A SEND. For a personal saved email, send only when explicitly authorized using post_message-drafts_id_send with the current updatedAt as expectedUpdatedAt, recipient, subject, body and accountIdentifier. That door queues once and returns the same receipt on retry. For a text, post_comms_send dispatches it separately. Cancel bins an unsent draft.
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/jsonrequiredResponses
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"
}