POST /v1/tasks/search
POST
/v1/tasks/search
const url = 'https://seu-endereco-da-api/v1/tasks/search';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"group":"priorizada","status":"example","cursor":"example","limit":1,"scope":"mine","filter":{},"tz":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://seu-endereco-da-api/v1/tasks/search \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "group": "priorizada", "status": "example", "cursor": "example", "limit": 1, "scope": "mine", "filter": {}, "tz": "example" }'Permissão que a Chave de acesso precisa: Ler tarefas (tasks:read).
Authorizations
Seção intitulada “Authorizations”Request Bodyrequired
Seção intitulada “Request Bodyrequired”Media typeapplication/json
object
group
string
status
string
cursor
string
limit
number
scope
string
filter
object
key
additional properties
any
tz
string
Responses
Seção intitulada “Responses”Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
title
required
string
kind
required
string
status
required
string
priority
required
string
dueAt
required
string format: date-time
origin
required
string
isRequired
required
Blocks moving the linked deal while open
boolean
notifyBeforeMinutes
required
number
assigneeId
required
string
canComplete
required
Se quem chama pode concluir esta tarefa: tasks:manage e a regra de conclusao (tarefa propria ou livre, tasks:manage_all; obrigatoria em negocio alheio pede o dono do negocio ou deals:manage_all)
boolean
canWork
required
Se quem chama pode trabalhar a tarefa (editar, adiar, fixar, cancelar, checklist): tarefa livre, propria ou tasks:manage_all
boolean
assignee
required
object
name
required
Nome, apelido de atendimento ou e-mail de quem a tarefa é
string
contact
required
object
name
required
string
deal
required
object
id
required
string
title
required
string
value
required
Valor em centavos
number
stageEnteredAt
required
string
stage
required
object
name
required
string
colorKey
required
string
staleDays
required
Dias sem mover nesta etapa a partir dos quais o negocio conta como parado
number
pipeline
required
object
id
required
string
staleDays
required
Limite de parado com que uma etapa nova deste pipeline nasce; o que vale para o negocio e o da etapa
number
group
required
string
rank
required
number
rankReason
required
string
contactTaskCount
required
number
probablyDone
required
boolean
checklistDone
required
number
nextCursor
required
string
Example generated
{ "items": [ { "id": "example", "title": "example", "kind": "example", "status": "example", "priority": "example", "dueAt": "2026-04-15T12:00:00Z", "origin": "example", "isRequired": true, "notifyBeforeMinutes": 1, "assigneeId": "example", "canComplete": true, "canWork": true, "assignee": { "name": "example" }, "contact": { "name": "example" }, "deal": { "id": "example", "title": "example", "value": 1, "stageEnteredAt": "example", "stage": { "name": "example", "colorKey": "example", "staleDays": 1 }, "pipeline": { "id": "example", "staleDays": 1 } }, "group": "example", "rank": 1, "rankReason": "example", "contactTaskCount": 1, "probablyDone": true, "checklistDone": 1 } ], "nextCursor": "example"}