> ## Documentation Index
> Fetch the complete documentation index at: https://developers.sults.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Listar tarefas em projetos
> Lista as tarefas dos projetos no módulo de Projetos. A busca é **paginada** e limitada a **100 registros** por página.
## OpenAPI
````yaml /api-reference/openapi.json get /api/v1/projeto/{projetoId}/tarefa
openapi: 3.1.0
info:
title: API SULTS
version: v1
description: >-
API REST do SULTS. Todas as chamadas devem ser autenticadas por um token
enviado, puro e sem o prefixo `Bearer`, no cabeçalho HTTP `Authorization`.
As datas seguem o formato UTC ISO 8601 (`yyyy-MM-ddTHH:mm:ssZ`) e campos com
máscara (CNPJ, telefone, CEP etc.) são retornados sem máscara. Endpoints de
listagem paginados aceitam os parâmetros `start` e `limit`.
contact:
name: Suporte SULTS
url: https://ajuda.sults.com.br
servers:
- url: https://api.sults.com.br
description: Produção
security:
- apiKeyAuth: []
tags:
- name: Unidades
description: >-
Unidades da rede e colaboradores ativos cadastrados no SULTS. Somente
leitura: a API não grava unidades nem colaboradores. A API do SULTS é REST
sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho
`Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado
por um administrador na plataforma, em Segurança > API > Gestão de Tokens
v1. O limite é de 2 requisições por segundo, por IP.
- name: Chamados
description: >-
Chamados abertos na plataforma e a timeline de cada um, com os endpoints
de criação e conclusão. A API do SULTS é REST sobre HTTPS e responde em
JSON. Cada requisição leva o token no cabeçalho `Authorization`, enviado
puro, sem o prefixo `Bearer`. O token é gerado por um administrador na
plataforma, em Segurança > API > Gestão de Tokens v1. O limite é de 2
requisições por segundo, por IP.
- name: Checklist
description: >-
Avaliações de checklist aplicadas nas unidades, com respostas, check-ins,
check-outs e planos de ação. A API do SULTS é REST sobre HTTPS e responde
em JSON. Cada requisição leva o token no cabeçalho `Authorization`,
enviado puro, sem o prefixo `Bearer`. O token é gerado por um
administrador na plataforma, em Segurança > API > Gestão de Tokens v1. O
limite é de 2 requisições por segundo, por IP.
- name: Compras
description: >-
Pedidos de compra e catálogo de produtos da v1, incluindo o cadastro e a
edição de produto e a edição de pedido. A v1 de Compras não recebe novas
funcionalidades: mix de produtos, etapas de pedido e as próximas novidades
do módulo estão só na API v2, que é a indicada para integrações novas de
Compras. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada
requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o
prefixo `Bearer`. O token é gerado por um administrador na plataforma, em
Segurança > API > Gestão de Tokens v1. O limite é de 2 requisições por
segundo, por IP.
- name: implantacao
description: >-
Projetos de implantação de novas unidades e as tarefas de cada projeto. A
API do SULTS é REST sobre HTTPS e responde em JSON. Cada requisição leva o
token no cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`.
O token é gerado por um administrador na plataforma, em Segurança > API >
Gestão de Tokens v1. O limite é de 2 requisições por segundo, por IP.
x-group: Implantação
- name: Projetos
description: >-
Projetos da operação e as tarefas vinculadas a eles. A API do SULTS é REST
sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho
`Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado
por um administrador na plataforma, em Segurança > API > Gestão de Tokens
v1. O limite é de 2 requisições por segundo, por IP.
- name: expansao
description: >-
Negócios do funil de Expansão e a timeline de cada um, com o endpoint de
criação de negócio. A API do SULTS é REST sobre HTTPS e responde em JSON.
Cada requisição leva o token no cabeçalho `Authorization`, enviado puro,
sem o prefixo `Bearer`. O token é gerado por um administrador na
plataforma, em Segurança > API > Gestão de Tokens v1. O limite é de 2
requisições por segundo, por IP.
x-group: Expansão
paths:
/api/v1/projeto/{projetoId}/tarefa:
get:
tags:
- Projetos
summary: Listar tarefas em projetos
description: >-
Lista as tarefas dos projetos no módulo de Projetos. A busca é
**paginada** e limitada a **100 registros** por página.
operationId: listarTarefasProjeto
parameters:
- name: projetoId
in: path
required: true
description: Id do projeto
schema:
type: integer
example: 58
- $ref: '#/components/parameters/Start'
- $ref: '#/components/parameters/Limit'
responses:
'200':
description: Lista paginada de tarefas
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ProjetoTarefa'
start:
type: integer
description: Página retornada
limit:
type: integer
description: Registros por página
totalPage:
type: integer
description: Quantidade de páginas disponíveis
size:
type: integer
description: Quantidade de registros na página
'400':
$ref: '#/components/responses/ErroValidacao'
'401':
$ref: '#/components/responses/TokenInvalido'
'404':
$ref: '#/components/responses/NaoEncontrado'
'429':
$ref: '#/components/responses/LimiteDeRequisicoes'
5XX:
$ref: '#/components/responses/ErroDoServidor'
components:
parameters:
Start:
name: start
in: query
description: >-
Número da página da listagem, começando em `0`. Incremente até a
resposta vir vazia ou até atingir `totalPage`.
schema:
type: integer
minimum: 0
default: 0
example: 0
Limit:
name: limit
in: query
description: Quantidade de registros por página. O máximo aceito pela API é `100`.
schema:
type: integer
minimum: 1
maximum: 100
default: 100
example: 100
schemas:
ProjetoTarefa:
type: object
properties:
id:
type: integer
description: Código da Tarefa
example: 1
nome:
type: string
description: Nome da Tarefa
example: Aprovar o layout da cozinha
codigo:
type: string
description: Código da Tarefa dentro da Fase do Projeto
example: '2.3'
fase:
type: object
description: Fase da Tarefa
properties:
id:
type: integer
description: Código da Fase
example: 1
nome:
type: string
description: Nome da Fase
example: Obras e instalações
codigo:
type: string
description: Código da Fase dentro do Projeto
example: '2'
responsavel:
type: object
description: Pessoa responsável pela Tarefa
properties:
id:
type: integer
description: Código
example: 1
nome:
type: string
description: Nome
example: Bruno Almeida
funcao:
type: object
description: Função à qual a Tarefa está atribuída
properties:
id:
type: integer
description: Código
example: 1
nome:
type: string
description: Nome
example: Arquiteto
descricaoHtml:
type: string
description: Descrição da Tarefa (HTML)
example: Café torrado e moído, pacote de 500 g.
prioridade:
type: integer
enum:
- 0
- 1
- 2
- 3
description: >-
O significado de cada valor ainda não foi confirmado pela
engenharia. Enquanto isso, trate o campo como um código opaco e não
derive regra de negócio a partir dele.
example: 0
situacao:
type: integer
enum:
- 1
- 2
- 3
- 4
- 5
description: >-
O significado de cada valor ainda não foi confirmado pela
engenharia. Enquanto isso, trate o campo como um código opaco e não
derive regra de negócio a partir dele.
example: 1
dtCriacao:
type: string
format: date-time
description: Data em que a Tarefa foi criada (UTC ISO 8601)
example: '2026-06-02T13:05:00Z'
dtInicio:
type: string
format: date-time
description: Data em que a Tarefa foi iniciada (UTC ISO 8601)
example: '2026-07-01T12:00:00Z'
dtFim:
type: string
format: date-time
description: Data em que a Tarefa foi finalizada (UTC ISO 8601)
example: '2026-07-10T21:00:00Z'
dtConclusao:
type: string
format: date-time
description: Data em que a Tarefa foi concluída (UTC ISO 8601)
example: '2026-07-09T17:48:26Z'
porcentagemConclusao:
type: number
description: Porcentagem de conclusão da Tarefa
example: 1
anexo:
type: array
items:
$ref: '#/components/schemas/ProjetoAnexo'
description: Anexos da Tarefa
subTarefa:
type: array
description: SubTarefas da Tarefa
items:
type: object
properties:
id:
type: integer
description: Código da SubTarefa
example: 1
nome:
type: string
description: Nome da SubTarefa
example: Enviar a planta para a franqueadora
dtCriacao:
type: string
format: date-time
description: Data em que a SubTarefa foi criada (UTC ISO 8601)
example: '2026-06-02T13:06:00Z'
dtConcluido:
type:
- string
- 'null'
format: date-time
description: >-
Data em que a SubTarefa foi concluída (UTC ISO 8601). Nulo se
não concluída.
example: '2026-07-03T14:20:00Z'
membro:
type: array
items:
type: object
description: Pessoa incluída na Tarefa
properties:
id:
type: integer
description: Código
example: 1
nome:
type: string
description: Nome
example: Juliana Prado
description: Pessoas incluídas na Tarefa
predecessora:
type: array
description: Tarefas predecessoras da Tarefa
items:
type: object
properties:
tarefa:
type: object
description: Tarefa à qual a dependência está vinculada
properties:
id:
type: integer
description: Código
example: 1
nome:
type: string
description: Nome
example: Assinar o contrato de locação
tipo:
type: integer
enum:
- 1
- 2
- 3
- 4
description: >-
Relação com a tarefa predecessora.
| Valor | Significado |
|-------|-------------|
| 1 | Após o início da predecessora |
| 4 | Após o término da predecessora |
Os demais valores retornados pela API ainda não têm
significado confirmado pela engenharia e por isso não estão
descritos aqui.
example: 1
intervaloDia:
type: integer
description: >-
Intervalo de dias para iniciar a Tarefa com base no tipo da
predecessora
example: 1
comentario:
type: array
description: Comentários da Tarefa
items:
type: object
properties:
id:
type: integer
description: Código do comentário
example: 1
mensagemHtml:
type: string
description: Mensagem do comentário (HTML)
example: Chamado aberto pela unidade.
dtCriacao:
type: string
format: date-time
description: Data em que o comentário foi criado (UTC ISO 8601)
example: '2026-07-02T09:31:45Z'
pessoa:
type: object
description: Pessoa que fez o comentário
properties:
id:
type: integer
description: Código
example: 1
nome:
type: string
description: Nome
example: Fernanda Rocha
ProjetoAnexo:
type: object
properties:
id:
type: integer
description: Código do Anexo
example: 1
nome:
type: string
description: Nome do Anexo
example: planta-baixa.pdf
url:
type: string
description: URL de download do Anexo
example: https://api.sults.com.br
tamanho:
type: integer
description: Tamanho do Anexo
example: 3
dtCriacao:
type: string
format: date-time
description: Data em que o Anexo foi criado (UTC ISO 8601)
example: '2026-06-20T15:42:10Z'
Erro:
type: object
description: >-
Corpo padrão de erro da API. Não existe código de erro interno: decida a
sua lógica pelo status HTTP e use a mensagem apenas para logs e
diagnóstico.
required:
- error
properties:
error:
type: string
description: >-
Mensagem legível, em português, descrevendo a falha. O texto pode
mudar: nunca o use como condição de código.
example: Campo responsavel não pode ser vazio ou nulo.
responses:
ErroValidacao:
description: >-
Erro de validação ou formato errado nos dados de entrada. A API aponta
**um campo por vez**: corrija o campo indicado na mensagem, reenvie e
repita até o 200.
content:
application/json:
schema:
$ref: '#/components/schemas/Erro'
example:
error: Campo responsavel não pode ser vazio ou nulo.
TokenInvalido:
description: >-
Token ausente ou inválido. Confira: copiado por completo, cabeçalho
`Authorization` com o nome exato, valor sem o prefixo `Bearer` e gerado
na **Gestão de Tokens v1** (tokens v2 não funcionam nesta API). Sem
retry automático. O corpo real é `{"error": "Acesso não autorizado."}`.
content:
application/json:
schema:
$ref: '#/components/schemas/Erro'
example:
error: Acesso não autorizado.
NaoEncontrado:
description: >-
Recurso ou entidade inexistente (por exemplo, um `{id}` do caminho que
não existe ou foi excluído no SULTS). Reenviar sem corrigir devolve o
mesmo erro.
content:
application/json:
schema:
$ref: '#/components/schemas/Erro'
LimiteDeRequisicoes:
description: >-
Limite de requisições excedido: **2 requisições por segundo, por IP**. A
resposta é a página HTML padrão do servidor, não JSON, e não há o header
`Retry-After`: trate pelo status 429, sem fazer parse do corpo, com
espera crescente a partir de 1 segundo.
content:
text/html:
schema:
type: string
description: >-
Página HTML padrão do servidor. Não faça parse; decida pelo
status.
ErroDoServidor:
description: >-
Falha inesperada do servidor (raro). Repita com espera crescente;
persistindo, acione o suporte com data, hora e endpoint.
content:
application/json:
schema:
$ref: '#/components/schemas/Erro'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Token gerado através do sistema do SULTS. Deve ser enviado no cabeçalho
`Authorization` de todas as requisições.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.