/v1/mail-connections/{id}/operationChange a mailbox folder or message flags
Create or rename a native Yahoo/AOL folder, move an existing message, or set read/starred/answered/draft flags. Requires your own connected mailbox, write consent and provider activation. Use folder, uid_validity and uid from a message appearance or received event; never guess them. Supply a stable UUID operation_id. An uncertain outcome must be checked in the mailbox before another operation; never retry with a new ID. Operational use only; no advertising.
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/jsonrequiredValues: "create_folder" · "move_message" · "rename_folder" · "set_flags"
Responses
the action's answer
{
"data": {
"operation_id": "",
"status": "string"
},
"no_advertising": true,
"source_provider": "string"
}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"
}