Saltar para a documentação
Servidor MCP

Notas

Notas privadas afixadas a uma conversa.

Ferramentas de notas

FerramentaO que faz
listThreadNotesAs notas de uma conversa, primeiro as afixadas, cada uma com o id que as outras ferramentas de notas recebem.
addThreadNoteAfixar uma nota a uma conversa, numa das oito cores que a aplicação oferece. Fica depois das outras, e uma nota afixada fica no topo.
updateThreadNoteAlterar o texto de uma nota, a sua cor ou se está afixada.
deleteThreadNoteEliminar uma nota de vez. As notas não têm lixo.
reorderThreadNotesOrdenar as notas de uma conversa nomeando-as todas, da primeira à última.

As notas são privadas de quem as escreveu, por isso estas ferramentas leem e escrevem as notas da pessoa que ligou o cliente. Ler requer threads:read e alterar threads:write, e um cliente limitado a alguns endereços só alcança as conversas que chegaram a eles.

No chat da aplicação, acrescentar, alterar, eliminar e ordenar notas pergunta primeiro, a menos que o tenha pedido.

Referência

listThreadNotes

Âmbitosthreads:readO assistente da app executa-o sem perguntarConjunto de ferramentasnotes

The private notes on one email thread, pinned ones first, each with the id the other note tools take. Notes belong to the person who wrote them, so this is that person's view.

Entradas

threadIdstringObrigatório
Não vazio

Também disponível em

API
GET /threads/{id}/notes
SDK
threads.listNotes()

addThreadNote

Âmbitosthreads:writeO assistente da app pergunta primeiro, a menos que o tenha pedidoConjunto de ferramentasnotes

Pin a private note to an email thread, as the Notes panel does. It goes after the other notes, and pinned keeps it at the top. color is one of the eight the app offers.

Entradas

threadIdstringObrigatório
Não vazio
contentstringObrigatório
De 1 a 20000 caracteres
colorstring
Um de"default""red""orange""yellow""green""blue""purple""pink"
pinnedboolean

Também disponível em

API
POST /threads/{id}/notes
SDK
threads.createNote()

updateThreadNote

Âmbitosthreads:writeO assistente da app pergunta primeiro, a menos que o tenha pedidoConjunto de ferramentasnotes

Change a note on a thread: its text, its colour or whether it is pinned. Give at least one. Take the note id from listThreadNotes.

Entradas

threadIdstringObrigatório
Não vazio
noteIdstringObrigatório
De 1 a 64 caracteres
contentstring
De 1 a 20000 caracteres
colorstring
Um de"default""red""orange""yellow""green""blue""purple""pink"
pinnedboolean

Também disponível em

API
PATCH /threads/{id}/notes/{noteId}
SDK
threads.updateNote()

deleteThreadNote

Âmbitosthreads:writeO assistente da app pergunta primeiro, a menos que o tenha pedidoConjunto de ferramentasnotes

Delete a note from a thread for good. There is no bin for notes. Take the note id from listThreadNotes.

Entradas

threadIdstringObrigatório
Não vazio
noteIdstringObrigatório
De 1 a 64 caracteres

Também disponível em

API
DELETE /threads/{id}/notes/{noteId}
SDK
threads.deleteNote()

reorderThreadNotes

Âmbitosthreads:writeO assistente da app pergunta primeiro, a menos que o tenha pedidoConjunto de ferramentasnotes

Arrange the notes on a thread, first to last. noteIds has to name every note on the thread exactly once; pinned notes still come first.

Entradas

threadIdstringObrigatório
Não vazio
noteIdsstring[]Obrigatório
De 1 a 200 itens

Também disponível em

API
POST /threads/{id}/notes/reorder
SDK
threads.reorderNotes()