> ## 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 o Caderno

> Define qual página é a [página principal](https://docs.olie.ai/guides/notebook/pages#a-página-principal) do Caderno. A página precisa estar na raiz do mesmo Caderno. Aceita token de aplicação.



## OpenAPI

````yaml /api-reference/openapi.json patch /api/management/forums/{forum_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}:
    parameters:
      - name: forum_id
        in: path
        required: true
        description: ID (UUID) do Caderno.
        schema:
          type: string
        example: ''
    patch:
      tags:
        - forums
      summary: Atualizar o Caderno
      description: >-
        Define qual página é a [página
        principal](https://docs.olie.ai/guides/notebook/pages#a-página-principal)
        do Caderno. A página precisa estar na raiz do mesmo Caderno. Aceita
        token de aplicação.
      requestBody:
        content:
          application/json:
            schema:
              description: Dados do Caderno a alterar.
              type: object
              properties:
                default_thread_id:
                  type: integer
                  description: >-
                    ID da página que passa a ser a página principal. Precisa ser
                    uma página da raiz deste Caderno.
              additionalProperties: false
            example:
              default_thread_id: null
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Resposta com o Caderno.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre `true` em caso de sucesso.
                  forum:
                    type: object
                    description: Caderno atualizado.
                    properties:
                      id:
                        type: string
                        description: ID (UUID) do Caderno.
                        format: uuid
                      old_id:
                        type: integer
                        description: Uso interno da plataforma; pode ser ignorado.
                      frame_id:
                        type: string
                        description: ID (UUID) da empresa.
                        format: uuid
                      model_id:
                        type: string
                        description: ID do registro dono do Caderno.
                      model_class:
                        type: string
                        description: Tipo do registro dono do Caderno.
                      default_thread_id:
                        type: integer
                        description: ID da página principal do Caderno.
                      created_at:
                        type: string
                        description: Data de criação.
                        format: date-time
                      updated_at:
                        type: string
                        description: Data da última alteração.
                        format: date-time
                      deleted_at:
                        type: string
                        description: Data de remoção; `null` para Caderno ativo.
                        format: date-time
              example:
                response: true
                forum:
                  id: 3f6b2a1c-9d8e-4f7a-b6c5-d4e3f2a1b0c9
                  old_id: null
                  frame_id: 7c0e1d2f-3a4b-5c6d-7e8f-9a0b1c2d3e4f
                  model_id: 8a1f2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c
                  model_class: App\Models\Project
                  default_thread_id: 1202
                  created_at: '2026-11-03T13:10:00.000000Z'
                  updated_at: '2026-11-09T14:22:05.000000Z'
                  deleted_at: null
        '404':
          description: Caderno de outra empresa
          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: forum_model_not_found
                error: >-
                  No query results for model [App\Models\Forum]
                  3f6b2a1c-9d8e-4f7a-b6c5-d4e3f2a1b0c9
        '422':
          description: Página de outro Caderno
          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 de outro Caderno:
                  value:
                    response: false
                    message: default_thread_are_not_found
                    error: The default thread informed are not found in that forum
                Página fora da raiz:
                  value:
                    response: false
                    message: default_thread_must_be_on_root
                    error: >-
                      To set a thread as default, it must be on the root of
                      forum, without parents
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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