Lista as tarefas de um ticket

GET

/v1/tickets/{ticketId}/tasks

Shell / cURL

curl --request GET \
  --url 'https://public-api.mspdesk.com.br/v1/tickets/1/tasks?filter%5Bid%5D%5Bin%5D=1%2C2%2C3&filter%5BagentId%5D%5Bin%5D=1%2C2%2C3&filter%5Bdeadline%5D%5Bgte%5D=2026-09-23T14%3A30&filter%5Bdeadline%5D%5Blte%5D=2026-09-23T14%3A30&limit=25&sort=-position&fields=id%2Ctitle%2Cdescription&expand=customer%2Cagent' \
  --header 'Authorization: Bearer <token>'

Escopo exigido: tickets:read. Paginação por cursor opaco (?cursor=), nunca por página/offset — use nextCursor da resposta anterior. A ordenação padrão é a da aba: position crescente, desempatada pelo id na mesma direção.

sort= aceita só position, deadline e id. createdAt e updatedAt são filtro e não ordenação: são colunas novas, nulas no que foi registrado antes desta API, e um valor nulo não serve de chave de paginação estável.

Ordenando por deadline, a tarefa sem prazo vai para o fim da ordem crescente (e para o começo da decrescente); ela continua publicando deadline: null. Para separá-las explicitamente, use filter[deadline][isNull]=true.

position é nula em tarefa anterior a esta API, e ela ordena antes de todas as demais — a mesma ordem que a tela mostra. A posição também pode ser negativa: é um número de ordenação relativo, não um índice.

filter[deadline][gte] e filter[deadline][lte] recebem data e hora sem fuso (2026-12-01T09:30), porque é isso que a coluna guarda; filter[createdAt][gte] e filter[updatedAt][gte], ao contrário, exigem o fuso (2026-09-23T14:30:00Z).

Autorizações

bearer

Parâmetros

Parâmetros de caminho

ticketId

required

integer format: int64

ID do ticket

Exemplo

Parâmetros de consulta

filter[id][eq]

integer format: int64

Filtra por id igual ao valor informado.

filter[id][in]

string

Exemplo

1,2,3

Filtra por id igual a um dos valores informados, separados por vírgula (até 100).

filter[completed][eq]

boolean

Filtra por completed igual ao valor informado.

filter[agentId][eq]

integer format: int64

Filtra por agentId igual ao valor informado.

filter[agentId][in]

string

Exemplo

1,2,3

Filtra por agentId igual a um dos valores informados, separados por vírgula (até 100).

filter[agentId][isNull]

boolean

Filtra por agentId ter ou não valor: true sem valor; false com valor.

filter[groupTitle][eq]

boolean

Filtra por groupTitle igual ao valor informado.

filter[deadline][gte]

string

Exemplo

2026-09-23T14:30

Filtra por deadline maior ou igual ao valor informado.

filter[deadline][lte]

string

Exemplo

2026-09-23T14:30

Filtra por deadline menor ou igual ao valor informado.

filter[deadline][isNull]

boolean

Filtra por deadline ter ou não valor: true sem valor; false com valor.

filter[createdAt][gte]

string format: date-time

Filtra por createdAt maior ou igual ao valor informado.

filter[createdAt][lte]

string format: date-time

Filtra por createdAt menor ou igual ao valor informado.

filter[updatedAt][gte]

string format: date-time

Filtra por updatedAt maior ou igual ao valor informado.

filter[updatedAt][lte]

string format: date-time

Filtra por updatedAt menor ou igual ao valor informado.

limit

integer format: int32

default: 25 >= 1 <= 100

Itens por página. 1 a 100; padrão 25.

cursor

string

Cursor opaco da próxima página, devolvido em nextCursor da resposta anterior. Omita na primeira página.

sort

string

Campo de ordenação: position, deadline, id (padrão position). Prefixe com - para descendente (ex.: sort=-position); sempre desempatado por id na mesma direção.

Exemplo

-position

fields

string

Campos de primeiro nível a retornar, separados por vírgula (id sempre volta): id, title, description, completed, groupTitle, position, deadline, agentId, createdById, createdAt, updatedAt.

Exemplo

id,title,description

expand

string

Objetos a acrescentar à resposta, separados por vírgula, até 3 por requisição: . Sem o escopo exigido de algum item pedido: 403 insufficient_scope.

Exemplo

customer,agent

Respostas

200

Página de tarefas

application/json

object

data

Array<object>

Tarefa (item da lista de afazeres) de um ticket.

object

agentId

Agente responsável pela tarefa. Nulo quando ninguém responde por ela — e sempre nulo em um título de grupo.

integer format: int64

nullable

completed

A tarefa está concluída. Sempre false em um título de grupo.

boolean

nullable

createdAt

Instante de criação do registro. Nulo em tarefa anterior a esta API.

string format: date-time

nullable

createdById

Agente que criou a tarefa. Nunca é nulo.

integer format: int64

nullable

deadline

Prazo da tarefa, sem fuso, em yyyy-MM-ddTHH:mm:ss — os segundos saem sempre, mesmo zerados, e a entrada os aceita como opcionais. Nulo quando a tarefa não tem prazo.

string

nullable

description

Descrição livre. Sempre nula em um título de grupo.

string

nullable

groupTitle

A linha é um título de grupo: um separador que agrupa as tarefas abaixo dele, sem prazo, responsável, descrição nem conclusão próprios.

boolean

nullable

Identificador da tarefa.

integer format: int64

position

Posição na ordem da aba, crescente. Nula em tarefa anterior a esta API, que nunca recebeu posição; a listagem a ordena antes de todas as outras. Pode ser negativa: é um número de ordenação relativo, não um índice. Não é editável pelo PATCH: quem a muda é POST /tasks/{taskId}/move.

integer format: int64

nullable

title

Título da tarefa.

string

nullable

updatedAt

Instante da última alteração do registro. Nulo em tarefa anterior a esta API que nunca foi alterada desde então.

string format: date-time

nullable

nextCursor

Cursor opaco da próxima página; null quando não há mais páginas.

string

nullable

Exemplo

{
  "data": [
    {
      "agentId": 42,
      "completed": false,
      "createdAt": "2026-01-10T12:30:00Z",
      "createdById": 42,
      "deadline": "2026-01-12T09:30:00",
      "description": "Conferir se o job noturno terminou sem erro.",
      "groupTitle": false,
      "id": 512,
      "position": 200,
      "title": "Validar o backup do servidor",
      "updatedAt": "2026-01-10T12:30:00Z"
    }
  ],
  "nextCursor": "eyJpZCI6MTA0Mn0"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

400

Requisição malformada ou parâmetros de consulta inválidos

application/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

401

Chave de API ausente, inválida, revogada ou expirada

application/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

403

Acesso negado: empresa inativa (account_inactive), API pública desabilitada para a empresa (public_api_disabled), escopo liberado só com a API pública (scope_requires_public_api) ou escopo insuficiente (insufficient_scope)

application/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

404

Recurso inexistente, de outra empresa, ou rota inexistente

application/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

429

Limite de uso atingido (rate_limited); o campo layer indica a camada: ip, company, key, operation ou concurrency

application/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

Retry-After

integer format: int32

Segundos até poder repetir

500

Erro interno inesperado

application/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo