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

# Promover um projeto a raiz

> Desliga o projeto de seu pai, deixando-o como raiz de uma nova estrutura. Os filhos do projeto acompanham a mudança e mantêm as posições relativas entre si. Projetos que já são raiz respondem com erro.



## OpenAPI

````yaml /api-reference/openapi.json put /api/management/projects/{project}/hierarchy/promote-to-root
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/promote-to-root:
    parameters:
      - name: project
        in: path
        required: true
        description: ID (UUID) do projeto.
        schema:
          type: string
        example: '{{project_id}}'
    put:
      tags:
        - projects
        - Hierarquia
      summary: Promover um projeto a raiz
      description: >-
        Desliga o projeto de seu pai, deixando-o como raiz de uma nova
        estrutura. Os filhos do projeto acompanham a mudança e mantêm as
        posições relativas entre si. Projetos que já são raiz respondem com
        erro.
      operationId: removerUmProjetoDeSuaHierarquiaAtual
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Confirmação da promoção a raiz.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                  data:
                    type: object
                    description: Resultado da promoção.
                    properties:
                      project:
                        type: object
                        description: Projeto promovido.
                        properties:
                          id:
                            type: string
                            description: ID (UUID) do projeto.
                            format: uuid
                          name:
                            type: string
                            description: Nome do projeto.
                          is_root:
                            type: boolean
                            description: 'Sempre true: o projeto passou a ser raiz.'
                      former_parent:
                        type: object
                        description: Identificação resumida de um projeto.
                        properties:
                          id:
                            type: string
                            description: ID (UUID) do projeto.
                            format: uuid
                          name:
                            type: string
                            description: Nome do projeto.
                required:
                  - response
                  - data
              example:
                response: true
                data:
                  project:
                    id: 019e0f21-4b3c-71a8-8f0e-9c2d5a7b1e40
                    name: Fundação
                    is_root: true
                  former_parent:
                    id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf
                    name: Shopping Center
        '422':
          description: Projeto já é raiz
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre false em respostas de erro.
                  message:
                    type: string
                    description: Descrição do motivo da recusa.
                description: Erro sem identificador de código.
                required:
                  - response
                  - message
              example:
                response: false
                message: Project is already at root level
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````