> ## 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 análises dos descendentes

> Consolida em um único retorno os números de todos os projetos abaixo do projeto informado — financeiro, tarefas, funis e pessoas envolvidas — para uma visão macro da estrutura.

Projetos sem nenhum descendente respondem com erro, já que não há o que consolidar.



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/projects/{project}/hierarchy/analytics
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/analytics:
    parameters:
      - name: project
        in: path
        required: true
        description: ID (UUID) do projeto.
        schema:
          type: string
        example: '{{project_id}}'
    get:
      tags:
        - projects
        - Hierarquia
      summary: Obter análises dos descendentes
      description: >-
        Consolida em um único retorno os números de todos os projetos abaixo do
        projeto informado — financeiro, tarefas, funis e pessoas envolvidas —
        para uma visão macro da estrutura.


        Projetos sem nenhum descendente respondem com erro, já que não há o que
        consolidar.
      operationId: listarAnLisesAgregadasDeTodosOsProjetosDescendentes
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Análises agregadas da hierarquia.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                  data:
                    type: object
                    description: Números consolidados dos descendentes.
                    properties:
                      budget:
                        type: object
                        description: Números financeiros.
                        properties:
                          total_budget:
                            type: number
                            description: Soma dos orçamentos.
                          average_budget:
                            type: number
                            description: Média dos orçamentos maiores que zero.
                          budget_distribution:
                            type: object
                            description: Quantidade de projetos por valor de orçamento.
                          projects_with_budget:
                            type: integer
                            description: Projetos com orçamento.
                          projects_without_budget:
                            type: integer
                            description: Projetos sem orçamento.
                          budget_range:
                            type: object
                            description: Faixa de orçamento.
                            properties:
                              min:
                                type: number
                                description: Menor orçamento.
                              max:
                                type: number
                                description: Maior orçamento.
                      funnels:
                        type: object
                        description: Números de funis.
                        properties:
                          total_funnels:
                            type: integer
                            description: Funis distintos usados pelos descendentes.
                          average_funnels_per_project:
                            type: number
                            description: Média de funis por projeto.
                          funnels_per_project:
                            type: object
                            description: Quantidade de funis por projeto.
                          projects_per_step:
                            type: object
                            description: Quantidade de projetos por etapa.
                          projects_with_funnels:
                            type: integer
                            description: Projetos em algum funil.
                          projects_without_funnels:
                            type: integer
                            description: Projetos fora de qualquer funil.
                      users:
                        type: object
                        description: Números de pessoas.
                        properties:
                          total_users:
                            type: integer
                            description: Pessoas distintas envolvidas.
                          total_user_assignments:
                            type: integer
                            description: Total de vínculos de pessoas com projetos.
                          average_users_per_project:
                            type: number
                            description: Média de pessoas por projeto.
                          users_by_role:
                            type: object
                            description: Quantidade de vínculos por papel.
                          users_per_project:
                            type: object
                            description: Quantidade de pessoas por projeto.
                          projects_with_users:
                            type: integer
                            description: Projetos com alguém vinculado.
                          projects_without_users:
                            type: integer
                            description: Projetos sem ninguém vinculado.
                      status:
                        type: object
                        description: Distribuição por situação.
                        properties:
                          by_status:
                            type: object
                            description: Quantidade de projetos por situação.
                          total_projects:
                            type: integer
                            description: Total de projetos considerados.
                          status_distribution_percentage:
                            type: object
                            description: Percentual de projetos por situação.
                      impact:
                        type: object
                        description: Distribuição por impacto.
                        properties:
                          by_impact:
                            type: object
                            description: Quantidade de projetos por grau de impacto.
                          average_impact:
                            type: number
                            description: Impacto médio.
                          impact_range:
                            type: object
                            description: Faixa de impacto.
                            properties:
                              min:
                                type: number
                                description: Menor impacto.
                              max:
                                type: number
                                description: Maior impacto.
                          high_impact_projects:
                            type: integer
                            description: Projetos com impacto 8 ou mais.
                          medium_impact_projects:
                            type: integer
                            description: Projetos com impacto de 4 a 7.
                          low_impact_projects:
                            type: integer
                            description: Projetos com impacto 3 ou menos.
                      hierarchy:
                        type: object
                        description: Formato da estrutura.
                        properties:
                          total_levels:
                            type: integer
                            description: Níveis ocupados pela estrutura.
                          level_distribution:
                            type: object
                            description: Quantidade de projetos por nível.
                          leaf_projects:
                            type: integer
                            description: Projetos sem filhos.
                          branch_projects:
                            type: integer
                            description: Projetos com filhos.
                          branch_to_leaf_ratio:
                            type: number
                            description: Relação entre projetos com e sem filhos.
                          average_children_per_branch:
                            type: number
                            description: Média de filhos por projeto que tem filhos.
                      timeline:
                        type: object
                        description: Evolução no tempo.
                        properties:
                          recent_projects:
                            type: object
                            description: Projetos criados por janela de tempo.
                            properties:
                              last_30_days:
                                type: integer
                                description: Criados nos últimos 30 dias.
                              last_90_days:
                                type: integer
                                description: Criados nos últimos 90 dias.
                              last_365_days:
                                type: integer
                                description: Criados nos últimos 365 dias.
                          recently_updated:
                            type: integer
                            description: Projetos alterados recentemente.
                          monthly_creation_trend:
                            type: object
                            description: Projetos criados por mês, no formato AAAA-MM.
                          oldest_project_age_days:
                            type: integer
                            description: Idade do projeto mais antigo, em dias.
                          newest_project_age_days:
                            type: integer
                            description: Idade do projeto mais novo, em dias.
                required:
                  - response
                  - data
              example:
                response: true
                data:
                  budget:
                    total_budget: 460000
                    average_budget: 230000
                    budget_distribution:
                      '120000': 1
                      '340000': 1
                    projects_with_budget: 2
                    projects_without_budget: 1
                    budget_range:
                      min: 0
                      max: 340000
                  funnels:
                    total_funnels: 1
                    average_funnels_per_project: 0.67
                    funnels_per_project:
                      019e0f21-4b3c-71a8-8f0e-9c2d5a7b1e40: 1
                    projects_per_step:
                      '181': 1
                    projects_with_funnels: 1
                    projects_without_funnels: 2
                  users:
                    total_users: 2
                    total_user_assignments: 3
                    average_users_per_project: 1
                    users_by_role:
                      assignee: 2
                      follower: 1
                    users_per_project:
                      019e0f21-4b3c-71a8-8f0e-9c2d5a7b1e40: 2
                    projects_with_users: 2
                    projects_without_users: 1
                  status:
                    by_status:
                      '1': 2
                      '2': 1
                    total_projects: 3
                    status_distribution_percentage:
                      '1': 66.67
                      '2': 33.33
                  impact:
                    by_impact:
                      '6': 1
                      '7': 1
                      '9': 1
                    average_impact: 7.33
                    impact_range:
                      min: 6
                      max: 9
                    high_impact_projects: 1
                    medium_impact_projects: 2
                    low_impact_projects: 0
                  hierarchy:
                    total_levels: 2
                    level_distribution:
                      '1': 2
                      '2': 1
                    leaf_projects: 2
                    branch_projects: 1
                    branch_to_leaf_ratio: 0.5
                    average_children_per_branch: 1
                  timeline:
                    recent_projects:
                      last_30_days: 1
                      last_90_days: 2
                      last_365_days: 3
                    recently_updated: 2
                    monthly_creation_trend:
                      2026-06: 1
                      2026-07: 1
                      2026-08: 1
                    oldest_project_age_days: 74
                    newest_project_age_days: 3
        '422':
          description: Projeto sem descendentes
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre false em respostas de erro.
                  message:
                    type: string
                    description: >-
                      Identificador do erro, usado pelo cliente para tratar o
                      caso.
                  error:
                    type: string
                    description: Descrição legível do erro.
                required:
                  - response
                  - message
                  - error
              example:
                response: false
                message: no_descendants_for_analytics
                error: No descendants found for project
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````