---
title: "Obter a árvore da hierarquia"
method: GET
path: "/api/management/projects/{project}/hierarchy/tree"
tags: ["projects", "Hierarquia"]
---

# Obter a árvore da hierarquia

`GET /api/management/projects/{project}/hierarchy/tree`

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).

## Response `200`

Sucesso

- object — Árvore completa a partir do projeto.
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `data` object, required — Árvore da hierarquia.
    - `current_project` object — Projeto consultado.
      - `id` string, uuid — ID (UUID) do projeto consultado.
      - `name` string — Nome do projeto.
      - `breadcrumb` string — Caminho da raiz até o projeto, separado por `>`.
    - `hierarchy_tree` object[] — Projeto consultado e todos os seus descendentes.
      - `id` string, uuid — ID (UUID) do projeto.
      - `name` string — Nome do projeto.
      - `description` string, nullable — Descrição do projeto.
      - `status` integer — Situação do projeto.
      - `parent_id` string, uuid, nullable — ID do projeto pai.
      - `level` integer — Nível na árvore, começando em 0.
      - `is_root` boolean — Indica que o projeto não tem pai.
      - `is_leaf` boolean — Indica que o projeto não tem filhos.
      - `children_count` integer — Filhos diretos.
    - `stats` object — Números da posição do projeto na hierarquia.
      - `level` integer — Nível do projeto na árvore, começando em 0 na raiz.
      - `depth` integer — Quantos níveis existem abaixo do projeto.
      - `children_count` integer — Filhos diretos.
      - `descendants_count` integer — Total de descendentes em todos os níveis.
      - `is_root` boolean — Indica que o projeto não tem pai.
      - `is_leaf` boolean — Indica que o projeto não tem filhos.

## Changes

- **2026-08-24** `3c590152d5b5` — 2 breaking, 2 info
  - the response property `data/hierarchy_tree/items/description` became nullable for the status `200`
  - the `data/hierarchy_tree/items/parent_id` response's property type changed from no type to `string`, and format from no format to `uuid` for status `200`
  - the response property `data` became required for the status `200`
  - the response property `response` became required for the status `200`
- **2026-08-19** `3d619d9db20d` — 3 info
  - api tag `Hierarquia` added
  - api tag `hierarchy` removed
  - api tag `{id}` removed
- **2026-08-19** `5501d8ecc8a0` — 1 info
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/projects/:project/hierarchy/tree/get.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)