> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter a árvore da hierarquia

> Retorna a árvore completa a partir do projeto informado — filhos, netos e bisnetos — com o nível de cada um, se é raiz ou folha, as estatísticas da estrutura e o caminho (breadcrumb) até o projeto atual.

A plataforma permite até quatro níveis de profundidade; veja [Hierarquia de projetos](https://docs.olie.ai/guides/projects/project-hierarchy).



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/projects/{project}/hierarchy/tree
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/projects/{project}/hierarchy/tree:
    parameters:
      - name: project
        in: path
        required: true
        description: ID (UUID) do projeto.
        schema:
          type: string
        example: '{{project_id}}'
    get:
      tags:
        - projects
        - Hierarquia
      summary: Obter a árvore da hierarquia
      description: >-
        Retorna a árvore completa a partir do projeto informado — filhos, netos
        e bisnetos — com o nível de cada um, se é raiz ou folha, as estatísticas
        da estrutura e o caminho (breadcrumb) até o projeto atual.


        A plataforma permite até quatro níveis de profundidade; veja [Hierarquia
        de projetos](https://docs.olie.ai/guides/projects/project-hierarchy).
      operationId: listarARvoreCompletaDeHierarquiaDeUmProjeto
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Árvore completa a partir do projeto.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                  data:
                    type: object
                    description: Árvore da hierarquia.
                    properties:
                      current_project:
                        type: object
                        description: Projeto consultado.
                        properties:
                          id:
                            type: string
                            description: ID (UUID) do projeto consultado.
                            format: uuid
                          name:
                            type: string
                            description: Nome do projeto.
                          breadcrumb:
                            type: string
                            description: Caminho da raiz até o projeto, separado por `>`.
                      hierarchy_tree:
                        type: array
                        description: Projeto consultado e todos os seus descendentes.
                        items:
                          description: Nó da árvore.
                          type: object
                          properties:
                            id:
                              type: string
                              description: ID (UUID) do projeto.
                              format: uuid
                            name:
                              type: string
                              description: Nome do projeto.
                            description:
                              type: string
                              description: Descrição do projeto.
                            status:
                              type: integer
                              description: Situação do projeto.
                            parent_id:
                              type: string
                              description: ID do projeto pai.
                              format: uuid
                            level:
                              type: integer
                              description: Nível na árvore, começando em 0.
                            is_root:
                              type: boolean
                              description: Indica que o projeto não tem pai.
                            is_leaf:
                              type: boolean
                              description: Indica que o projeto não tem filhos.
                            children_count:
                              type: integer
                              description: Filhos diretos.
                      stats:
                        type: object
                        description: Números da posição do projeto na hierarquia.
                        properties:
                          level:
                            type: integer
                            description: >-
                              Nível do projeto na árvore, começando em 0 na
                              raiz.
                          depth:
                            type: integer
                            description: Quantos níveis existem abaixo do projeto.
                          children_count:
                            type: integer
                            description: Filhos diretos.
                          descendants_count:
                            type: integer
                            description: Total de descendentes em todos os níveis.
                          is_root:
                            type: boolean
                            description: Indica que o projeto não tem pai.
                          is_leaf:
                            type: boolean
                            description: Indica que o projeto não tem filhos.
                required:
                  - response
                  - data
              example:
                response: true
                data:
                  current_project:
                    id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                    name: Shopping Center
                    breadcrumb: Shopping Center
                  hierarchy_tree:
                    - id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                      name: Shopping Center
                      description: Obra completa do empreendimento
                      status: 1
                      parent_id: null
                      level: 0
                      is_root: true
                      is_leaf: false
                      children_count: 2
                    - id: 019e0f21-4b3c-71a8-8f0e-9c2d5a7b1e40
                      name: Fundação
                      description: Serviços de fundação
                      status: 1
                      parent_id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                      level: 1
                      is_root: false
                      is_leaf: false
                      children_count: 1
                    - id: 019e0f23-1a5e-7460-9c33-2b7f8de10c55
                      name: Escavação
                      description: null
                      status: 2
                      parent_id: 019e0f21-4b3c-71a8-8f0e-9c2d5a7b1e40
                      level: 2
                      is_root: false
                      is_leaf: true
                      children_count: 0
                  stats:
                    level: 0
                    depth: 2
                    children_count: 2
                    descendants_count: 3
                    is_root: true
                    is_leaf: false
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````