create_email_folder
E-mail · macOS
Efeito: escrita. Estado: disponibilidade condicionada.
«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.
macOS
Finalidade
Cria uma caixa de correio (pasta) no Apple Mail (Mail.app) do Mac, em uma conta. Se o Mail tem mais de uma conta, `account` é obrigatório: a ferramenta se recusa a adivinhar onde a pasta vai (list_email_accounts dá os nomes). Se já existir uma pasta com esse nome, não cria nada e diz isso. Só informa created depois de ver a pasta na lista de pastas da conta; em uma conta Exchange, onde o Mail não consegue confirmar a pasta com o servidor, responde created=false com status server_unconfirmed: use m365_create_email_folder para essa caixa de correio. Chamada sem confirm, retorna uma prévia; passe confirm=true para criar.
Entradas obrigatórias
name
Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.
Permissões e confirmação
O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em inglês — macOS
{
"properties": {
"account": {
"description": "Account name (optional, uses default)",
"type": "string"
},
"confirm": {
"description": "Must be true to create",
"type": "boolean"
},
"name": {
"description": "Folder name",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}Exemplo documental
Exemplo de documentação para create_email_folder. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"confirm": false,
"name": "Planning meeting"
}