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

# Atualizar uma página

> Renomeia, [move](https://docs.olie.ai/guides/notebook/pages#mover-uma-página) ou reordena uma página. `name` é obrigatório em toda chamada, e omitir `parent_id` leva a página para a raiz: para só renomear uma subpágina, reenvie o `parent_id` atual. Aceita token de aplicação.



## OpenAPI

````yaml /api-reference/openapi.json patch /api/management/forums/{forum_id}/threads/{thread_id}
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/forums/{forum_id}/threads/{thread_id}:
    parameters:
      - name: forum_id
        in: path
        required: true
        description: ID (UUID) do Caderno.
        schema:
          type: string
        example: ''
      - name: thread_id
        in: path
        required: true
        description: ID da página (número inteiro).
        schema:
          type: string
        example: ''
    patch:
      tags:
        - forums
      summary: Atualizar uma página
      description: >-
        Renomeia,
        [move](https://docs.olie.ai/guides/notebook/pages#mover-uma-página) ou
        reordena uma página. `name` é obrigatório em toda chamada, e omitir
        `parent_id` leva a página para a raiz: para só renomear uma subpágina,
        reenvie o `parent_id` atual. Aceita token de aplicação.
      requestBody:
        content:
          application/json:
            schema:
              description: Dados da página.
              type: object
              properties:
                name:
                  type: string
                  maxLength: 255
                  description: >-
                    Nome da página (até 255 caracteres). Obrigatório em toda
                    chamada.
                parent_id:
                  type: integer
                  description: >-
                    ID da nova página pai. Se omitido ou `null`, a página vai
                    para a raiz.
                order:
                  type: integer
                  minimum: 0
                  description: >-
                    Nova posição entre as irmãs (0 ou mais). Se omitido, a
                    posição não muda.
              required:
                - name
              additionalProperties: false
            example:
              name: Escopo e entregas
              parent_id: null
              order: 0
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Resposta com a página.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre `true` em caso de sucesso.
                  thread:
                    type: object
                    description: Página do Caderno.
                    properties:
                      id:
                        type: integer
                        description: ID da página.
                      name:
                        type: string
                        description: Nome da página.
                      forum_id:
                        type: string
                        description: ID (UUID) do Caderno da página.
                        format: uuid
                      parent_id:
                        type: integer
                        description: ID da página pai; `null` quando a página está na raiz.
                      order:
                        type: integer
                        description: Posição da página entre as irmãs (crescente).
                      editor_type:
                        type: string
                        enum:
                          - tiptap
                          - editorjs
                        description: >-
                          Editor da página: `tiptap` (atual) ou `editorjs`
                          (anterior, somente leitura).
                      created_at:
                        type: string
                        description: Data de criação.
                        format: date-time
                      updated_at:
                        type: string
                        description: Data da última alteração dos dados da página.
                        format: date-time
                      deleted_at:
                        type: string
                        description: Data de remoção; `null` para página ativa.
                        format: date-time
                      cdn_migrated:
                        type: integer
                        description: Uso interno da plataforma; pode ser ignorado.
              example:
                response: true
                thread:
                  id: 1203
                  name: Wireframes aprovados
                  forum_id: 3f6b2a1c-9d8e-4f7a-b6c5-d4e3f2a1b0c9
                  parent_id: 1202
                  order: 2
                  editor_type: tiptap
                  created_at: '2026-11-03T13:10:00.000000Z'
                  updated_at: '2026-11-09T14:22:05.000000Z'
                  deleted_at: null
                  cdn_migrated: 0
        '404':
          description: Página não encontrada
          content:
            application/json:
              schema:
                type: object
                description: Resposta de erro.
                properties:
                  response:
                    type: boolean
                    description: Sempre `false` em caso de erro.
                  message:
                    type: string
                    description: >-
                      Identificador do erro (slug); é o campo a ser tratado pelo
                      cliente.
                  error:
                    type: string
                    description: Descrição legível do erro.
              example:
                response: false
                message: thread_model_not_found
                error: No query results for model [App\Models\Thread] 999999
        '422':
          description: Página como pai de si mesma
          content:
            application/json:
              schema:
                type: object
                description: Resposta de erro.
                properties:
                  response:
                    type: boolean
                    description: Sempre `false` em caso de erro.
                  message:
                    type: string
                    description: >-
                      Identificador do erro (slug); é o campo a ser tratado pelo
                      cliente.
                  error:
                    type: string
                    description: Descrição legível do erro.
              examples:
                Página como pai de si mesma:
                  value:
                    response: false
                    message: cant_be_self_parent
                    error: A thread parent can't be it self or theirs own childrens
                Página pai não encontrada:
                  value:
                    response: false
                    message: parent_thread_are_not_found
                    error: Unable to set thread parent because is isn't found
                Validação falhou:
                  value:
                    response: false
                    message: validation_errors
                    error: O campo name é obrigatório.
                    validation:
                      name:
                        - O campo name é obrigatório.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.