Workload
Resumo de capacidade do time (Workload)
Consulta (get) a visão de capacidade (Workload) do time, a mesma da tela Tarefas > Workload: por executor, quanto está alocado, quanto tem disponível e quanto há de trabalho atrasado. Os valores já vêm calculados, em minutos e em texto (campos *Formatted, como 2h30min): basta apresentá-los. Todos os parâmetros são opcionais. Por padrão considera de hoje até hoje + 6 dias; a data inicial nunca é anterior a hoje, como na tela. O período realmente calculado vem em period (confira period.startDate, period.endDate e period.adjusted); veja a observação sobre períodos longos em endDate. Só entram as tarefas ativas e não excluídas que o usuário pode ver. Tarefas ágeis com etapa de co-execução definida também são computadas para o co-executor, mas com previsto e realizado zerados (não somam minutos). Para as tarefas de um executor use get_workload_executor_tasks.
Query Parameters
Ids dos executores (usuários), separados por vírgula. Omita para trazer todos os executores com tarefas. Obtenha os ids em list_admin_editors_users. Id que não é de um usuário da empresa (convidados não contam) gera erro 400.
Ids de workspaces, separados por vírgula (apenas números), para considerar só as tarefas delas. Omita para todas as que o usuário pode ver. Obtenha os ids em list_short_workspaces. Id de workspace fora da empresa ou sem acesso gera erro 400.
Início do período, formato yyyy-MM-dd. Padrão: hoje. Nunca começa antes de hoje: datas passadas são deslocadas para hoje (e o fim é deslocado mantendo a mesma duração), como na tela.
dateFim do período, formato yyyy-MM-dd. Padrão: startDate + 6 dias. Não pode ser anterior a startDate. Atenção a períodos longos: quando a diferença entre startDate e endDate passa de 30 dias, a API desloca a data inicial em 30 dias (comportamento atual do código). A duração resultante não é necessariamente de 30 dias, e a regra de limite está pendente de esclarecimento, portanto não presuma um limite máximo. Confira sempre period.startDate, period.endDate e period.adjusted no retorno.
datetrue para incluir também executores sem nenhuma tarefa no período (totalmente disponíveis). Padrão: false.
summary (padrão): totais por executor. daily: acrescenta a grade dia a dia de cada executor (days). Comece por summary e use daily só se pedirem o detalhe por dia. Para as tarefas de um executor não use este parâmetro: use get_workload_executor_tasks.
"summary""summary" | "daily"curl -X GET "https://loading/tasks/workload/summary"