Buscar tarefas no Wrike, por uma API

Busca as tarefas da conta inteira, como as atribuídas a alguém ou com prazo nesta semana, até 1000 por página. Quando a resposta traz nextPageToken, envie-o para buscar a próxima página.

Identificador
wrike_search_tasks

A chamada

POST https://connect.reportei.com/api/tools/wrike_search_tasks/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "title": "<title>"
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
titlestringNãoOnly tasks whose title contains this text.
statusstringNãoOnly tasks in these statuses: JSON array of statuses, any of Active, Deferred, Completed and Cancelled, such as ["Active"].
importancestringNãoOnly tasks with this importance.Valores: High, Normal, Low
responsiblesstringNãoOnly tasks assigned to any of these users: JSON array of user ids from List contacts, such as ["KUAJ25LC"].
customStatusesstringNãoOnly tasks in these custom statuses: JSON array of custom status ids from List workflows, such as ["IEAAAAAAJMAAAAAA"].
startDatestringNãoStart date filter: JSON object with an exact date in equal, or a range in start and end, as yyyy-MM-dd with an optional THH:mm:ss, such as {"start":"2026-11-01","end":"2026-11-30"}.
dueDatestringNãoDue date filter: JSON object with an exact date in equal, or a range in start and end, as yyyy-MM-dd with an optional THH:mm:ss, such as {"start":"2026-11-01","end":"2026-11-30"}.
createdDatestringNãoCreated date filter: JSON object with start and end in UTC, as yyyy-MM-ddTHH:mm:ssZ, such as {"start":"2026-11-01T00:00:00Z","end":"2026-11-30T23:59:59Z"}.
updatedDatestringNãoUpdated date filter: JSON object with start and end in UTC, as yyyy-MM-ddTHH:mm:ssZ, such as {"start":"2026-11-01T00:00:00Z","end":"2026-11-30T23:59:59Z"}.
completedDatestringNãoCompleted date filter: JSON object with start and end in UTC, as yyyy-MM-ddTHH:mm:ssZ, such as {"start":"2026-11-01T00:00:00Z","end":"2026-11-30T23:59:59Z"}.
typestringNãoOnly tasks of this type: Planned has dates, Backlog has none, Milestone has only a due date.Valores: Planned, Backlog, Milestone
subTasksbooleanNãoTrue to also search the subtasks.
sortFieldstringNãoField the tasks are sorted by.Valores: Status, Importance, UpdatedDate, CreatedDate, Title, StartFinishInterval, DueDate, LastAccessDate, CompletedDate
sortOrderstringNãoSort order.Valores: Asc, Desc
pageSizeintegerNãoTasks per page, up to 1000.
nextPageTokenstringNãoThe nextPageToken of the previous response, to fetch the next page. Send the same fields again.
fieldsstringNãoJSON array of optional fields to add to each task, such as ["responsibleIds","description","customFields"]. Assignees and description only come when asked here.
permalinkstringNãoPermalink of a task, as Wrike shows it, to find that one.

Conexões possíveis

O seu cliente conecta a conta do Wrike uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

OAuth com o app do seu produto

Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/wrike, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.

Na conexão, o cliente informa também {host}: o endereço da conta dele na API do app.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/wrike_search_tasks. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do Wrike

Ver as 13 tools

Toolkits da mesma categoria

Ver os 100 toolkits

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.