Tarefas

add_checklist_item

Escrita

Adiciona um item ao checklist de uma tarefa.

Permissão

tasks:write

Operação

tasks.checklist.add

Módulo

tasks

Parâmetros

taskIdstringobrigatório

titlestringobrigatório

add_task_comment

Escrita

Comenta numa tarefa (ou responde a um comentário). Avisa os envolvidos.

Permissão

tasks:write

Operação

tasks.comments.create

Módulo

tasks

Parâmetros

taskIdstringobrigatório

contentstringobrigatório

parentIdstringopcional

Comentário que está sendo respondido.

add_task_label

Escrita

Põe uma etiqueta do quadro numa tarefa (repetir não faz nada).

Permissão

tasks:write

Operação

tasks.labels.add

Módulo

tasks

Parâmetros

taskIdstringobrigatório

labelIdstringobrigatório

assign_task

Escrita

Coloca alguém da equipe como responsável pela tarefa e avisa a pessoa (repetir não faz nada).

Permissão

tasks:write

Operação

tasks.assignees.add

Módulo

tasks

Parâmetros

taskIdstringobrigatório

userIdstringobrigatório

create_task

Escrita

Cria uma tarefa num quadro, com responsáveis, prazo, etiquetas e vínculo com contato ou conversa. Sem quadro, vai para o quadro padrão da empresa, na primeira coluna aberta. Para atividade de venda num negócio, use schedule_deal_activity.

Permissão

tasks:write

Operação

tasks.create

Módulo

tasks

Parâmetros

titlestringobrigatório

boardIdstringopcional

Quadro. Omita para o quadro padrão.

columnIdstringopcional

Coluna do quadro. Obrigatória quando boardId é informado.

descriptionstringopcional

dueDatestringopcional

Data (AAAA-MM-DD) ou data e hora ISO.

reminderAtstring (date-time)opcional

Lembrete por push neste horário (ISO 8601 com fuso).

prioritystringopcional

LOWMEDIUMHIGHURGENT

estimatedMinutesintegeropcional

assigneeIdsstring[]opcional

labelIdsstring[]opcional

contactIdstringopcional

conversationIdstringopcional

parentIdstringopcional

Tarefa mãe (para criar uma subtarefa).

aiGeneratedbooleanopcional

Marca a tarefa como criada por IA. Padrão: sim para chave de API e agente.

aiReasonstringopcional

workItemTypestringopcional

EPICSTORYTASKBUG

storyPointsintegeropcional

epicIdstringopcional

storyIdstringopcional

sprintIdstringopcional

delete_checklist_item

Escrita

Remove um item do checklist.

Permissão

tasks:write

Operação

tasks.checklist.delete

Módulo

tasks

Parâmetros

taskIdstringobrigatório

itemIdstringobrigatório

delete_task

Escrita

Apaga uma tarefa com comentários, checklist, anexos e subtarefas. Repetir não dá erro.

Permissão

tasks:write

Operação

tasks.delete

Módulo

tasks

Parâmetros

taskIdstringobrigatório

get_task

Leitura

Uma tarefa completa: descrição, checklist, subtarefas, atividade recente, responsáveis, etiquetas e conversa ou contato ligados.

Permissão

tasks:read

Operação

tasks.get

Módulo

tasks

Parâmetros

taskIdstringobrigatório

get_task_board

Leitura

Um quadro inteiro: colunas com as tarefas, etiquetas e membros. Para filtrar e paginar, use list_tasks.

Permissão

tasks:read

Operação

tasks.boards.get

Módulo

tasks

Parâmetros

boardIdstringobrigatório

list_task_boards

Leitura

Quadros de tarefas da empresa, com colunas, membros e quantas tarefas cada um tem.

Permissão

tasks:read

Operação

tasks.boards.list

Módulo

tasks

Parâmetros

Sem parâmetros.

list_tasks

Leitura

Tarefas de um quadro, paginadas, por coluna, responsável, etiqueta, atrasadas ou concluídas. Para buscar em todos os quadros, use search_tasks.

Permissão

tasks:read

Operação

tasks.board.list

Módulo

tasks

Parâmetros

boardIdstringobrigatório

columnIdstringopcional

assigneeIdstringopcional

labelIdstringopcional

overduebooleanopcional

Só as com prazo vencido e não concluídas.

completedbooleanopcional

Só concluídas (true) ou só abertas (false).

pageintegeropcional

limitintegeropcional

move_task

Escrita

Move a tarefa para uma coluna do mesmo quadro, numa posição (0 = topo). Coluna de concluído marca a tarefa como concluída.

Permissão

tasks:write

Operação

tasks.move

Módulo

tasks

Parâmetros

taskIdstringobrigatório

columnIdstringobrigatório

positionintegerobrigatório

Posição na coluna, a partir de 0.

remove_task_label

Escrita

Tira uma etiqueta de uma tarefa (se não tinha, não faz nada).

Permissão

tasks:write

Operação

tasks.labels.remove

Módulo

tasks

Parâmetros

taskIdstringobrigatório

labelIdstringobrigatório

search_tasks

Leitura

Busca tarefas em todos os quadros da empresa, por responsável, quadro, abertas, atrasadas ou com prazo até uma data. Prazo mais próximo primeiro. Para filtrar por coluna ou etiqueta dentro de um quadro, use list_tasks.

Permissão

tasks:read

Operação

tasks.list

Módulo

tasks

Parâmetros

assigneeIdstringopcional

boardIdstringopcional

openbooleanopcional

Só tarefas não concluídas.

overduebooleanopcional

Só tarefas com o prazo vencido.

dueBeforestring (date-time)opcional

Só tarefas com prazo até esta data (ISO 8601 com fuso).

pageintegeropcional

limitintegeropcional

toggle_checklist_item

Escrita

Marca ou desmarca um item do checklist.

Permissão

tasks:write

Operação

tasks.checklist.toggle

Módulo

tasks

Parâmetros

taskIdstringobrigatório

itemIdstringobrigatório

unassign_task

Escrita

Tira alguém dos responsáveis da tarefa (se não era, não faz nada).

Permissão

tasks:write

Operação

tasks.assignees.remove

Módulo

tasks

Parâmetros

taskIdstringobrigatório

userIdstringobrigatório

update_task

Escrita

Altera título, descrição, prioridade, prazo, estimativa, tarefa mãe ou, no quadro Scrum, tipo, pontos, épico, história e sprint. Nulo remove o valor.

Permissão

tasks:write

Operação

tasks.update

Módulo

tasks

Parâmetros

taskIdstringobrigatório

titlestringopcional

descriptionstringopcional

prioritystringopcional

LOWMEDIUMHIGHURGENT

dueDatestringopcional

reminderAtstring (date-time)opcional

Lembrete por push (ISO 8601 com fuso). Nulo tira.

estimatedMinutesintegeropcional

parentIdstringopcional

Tarefa mãe. Nulo solta a subtarefa.

workItemTypestringopcional

EPICSTORYTASKBUG

storyPointsintegeropcional

epicIdstringopcional

storyIdstringopcional

sprintIdstringopcional