Pular para o conteúdo

POST /v1/tasks/queue/search

POST
/v1/tasks/queue/search
curl --request POST \
--url https://seu-endereco-da-api/v1/tasks/queue/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "scope": "mine", "filter": {}, "tz": "example" }'

Permissão que a Chave de acesso precisa: Ler tarefas (tasks:read).

Media typeapplication/json
object
scope
string
Allowed values: mine department
filter
object
key
additional properties
any
tz
string
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
nullable
assigneeId
required
string
nullable
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
nullable
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
nullable
contactTaskCount
required
number
probablyDone
required
boolean
checklistDone
required
number
truncated
required

True quando a fila do dia bateu no teto de 200

boolean

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
}
],
"truncated": true
}