---
title: "Vincular um projeto filho"
method: POST
path: "/api/management/projects/{project}/hierarchy/attach-child"
tags: ["projects", "Hierarquia"]
---

# Vincular um projeto filho

`POST /api/management/projects/{project}/hierarchy/attach-child`

Torna um projeto existente filho direto do projeto informado. O vínculo é recusado quando criaria um ciclo, quando o projeto seria pai de si mesmo ou quando ultrapassaria o limite de quatro níveis de profundidade.

Regras completas em [Hierarquia de projetos](https://docs.olie.ai/guides/projects/project-hierarchy).

## Request body

- object — Projeto a vincular como filho.
  - `child_id` string, uuid, required — ID (UUID) do projeto que passa a ser filho.

## Response `200`

Sucesso

- object — Confirmação do vínculo pai-filho.
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `data` object, required — Vínculo criado.
    - `parent` object — Identificação resumida de um projeto.
      - `id` string, uuid — ID (UUID) do projeto.
      - `name` string — Nome do projeto.
    - `child` object — Identificação resumida de um projeto.
      - `id` string, uuid — ID (UUID) do projeto.
      - `name` string — Nome do projeto.
    - `new_hierarchy_breadcrumb` string — Novo caminho do filho, da raiz até ele.

## Other responses

- `422` — Vínculo inválido

## Changes

- **2026-08-24** `3c590152d5b5` — 4 breaking, 5 info
  - the request property `child_id` became not nullable
  - the request property `child_id` became required
  - the `child_id` request property type changed from no type to `string`, and format from no format to `uuid`
  - the `error` response's property format changed from `style` to no format for status `422`
  - …5 more
- **2026-08-19** `3d619d9db20d` — 3 info
  - api tag `Hierarquia` added
  - api tag `hierarchy` removed
  - api tag `{id}` removed
- **2026-08-19** `5501d8ecc8a0` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `422`
- **2026-08-19** `d270bef5be29` — 1 info
  - added optional request body

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/projects/:project/hierarchy/attach-child/post.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/85cb24130071/schema)