Tasks

add_checklist_item

Write

Adiciona um item ao checklist de uma tarefa.

Permission

tasks:write

Operation

tasks.checklist.add

Module

tasks

Parameters

taskIdstringrequired

titlestringrequired

add_task_comment

Write

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

Permission

tasks:write

Operation

tasks.comments.create

Module

tasks

Parameters

taskIdstringrequired

contentstringrequired

parentIdstringoptional

Comentário que está sendo respondido.

add_task_label

Write

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

Permission

tasks:write

Operation

tasks.labels.add

Module

tasks

Parameters

taskIdstringrequired

labelIdstringrequired

assign_task

Write

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

Permission

tasks:write

Operation

tasks.assignees.add

Module

tasks

Parameters

taskIdstringrequired

userIdstringrequired

create_task

Write

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.

Permission

tasks:write

Operation

tasks.create

Module

tasks

Parameters

titlestringrequired

boardIdstringoptional

Quadro. Omita para o quadro padrão.

columnIdstringoptional

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

descriptionstringoptional

dueDatestringoptional

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

reminderAtstring (date-time)optional

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

prioritystringoptional

LOWMEDIUMHIGHURGENT

estimatedMinutesintegeroptional

assigneeIdsstring[]optional

labelIdsstring[]optional

contactIdstringoptional

conversationIdstringoptional

parentIdstringoptional

Tarefa mãe (para criar uma subtarefa).

aiGeneratedbooleanoptional

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

aiReasonstringoptional

workItemTypestringoptional

EPICSTORYTASKBUG

storyPointsintegeroptional

epicIdstringoptional

storyIdstringoptional

sprintIdstringoptional

delete_checklist_item

Write

Remove um item do checklist.

Permission

tasks:write

Operation

tasks.checklist.delete

Module

tasks

Parameters

taskIdstringrequired

itemIdstringrequired

delete_task

Write

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

Permission

tasks:write

Operation

tasks.delete

Module

tasks

Parameters

taskIdstringrequired

get_task

Read

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

Permission

tasks:read

Operation

tasks.get

Module

tasks

Parameters

taskIdstringrequired

get_task_board

Read

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

Permission

tasks:read

Operation

tasks.boards.get

Module

tasks

Parameters

boardIdstringrequired

list_task_boards

Read

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

Permission

tasks:read

Operation

tasks.boards.list

Module

tasks

Parameters

No parameters.

list_tasks

Read

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

Permission

tasks:read

Operation

tasks.board.list

Module

tasks

Parameters

boardIdstringrequired

columnIdstringoptional

assigneeIdstringoptional

labelIdstringoptional

overduebooleanoptional

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

completedbooleanoptional

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

pageintegeroptional

limitintegeroptional

move_task

Write

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

Permission

tasks:write

Operation

tasks.move

Module

tasks

Parameters

taskIdstringrequired

columnIdstringrequired

positionintegerrequired

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

remove_task_label

Write

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

Permission

tasks:write

Operation

tasks.labels.remove

Module

tasks

Parameters

taskIdstringrequired

labelIdstringrequired

search_tasks

Read

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.

Permission

tasks:read

Operation

tasks.list

Module

tasks

Parameters

assigneeIdstringoptional

boardIdstringoptional

openbooleanoptional

Só tarefas não concluídas.

overduebooleanoptional

Só tarefas com o prazo vencido.

dueBeforestring (date-time)optional

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

pageintegeroptional

limitintegeroptional

toggle_checklist_item

Write

Marca ou desmarca um item do checklist.

Permission

tasks:write

Operation

tasks.checklist.toggle

Module

tasks

Parameters

taskIdstringrequired

itemIdstringrequired

unassign_task

Write

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

Permission

tasks:write

Operation

tasks.assignees.remove

Module

tasks

Parameters

taskIdstringrequired

userIdstringrequired

update_task

Write

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.

Permission

tasks:write

Operation

tasks.update

Module

tasks

Parameters

taskIdstringrequired

titlestringoptional

descriptionstringoptional

prioritystringoptional

LOWMEDIUMHIGHURGENT

dueDatestringoptional

reminderAtstring (date-time)optional

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

estimatedMinutesintegeroptional

parentIdstringoptional

Tarefa mãe. Nulo solta a subtarefa.

workItemTypestringoptional

EPICSTORYTASKBUG

storyPointsintegeroptional

epicIdstringoptional

storyIdstringoptional

sprintIdstringoptional