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

# Editar blocos do conteúdo de uma página

> Altera partes da página sem reenviar o documento inteiro: troca de texto, troca, inserção ou remoção de blocos, em Markdown. Os `ref` de bloco (`{índice}:{hash8}`) vêm da leitura da página pelo MCP (`read-notebook-page-tool`); sem eles, use `insert_blocks` com `position` ou `replace_text` sem `ref`. Se a página mudou depois da `base_revision`, as operações são reaplicadas sobre a versão atual, e um bloco alterado no meio do caminho gera erro 409. Aceita token de aplicação.



## OpenAPI

````yaml /api-reference/openapi.json patch /api/management/forums/{forum_id}/threads/{thread_id}/content
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}/content:
    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: Editar blocos do conteúdo de uma página
      description: >-
        Altera partes da página sem reenviar o documento inteiro: troca de
        texto, troca, inserção ou remoção de blocos, em Markdown. Os `ref` de
        bloco (`{índice}:{hash8}`) vêm da leitura da página pelo MCP
        (`read-notebook-page-tool`); sem eles, use `insert_blocks` com
        `position` ou `replace_text` sem `ref`. Se a página mudou depois da
        `base_revision`, as operações são reaplicadas sobre a versão atual, e um
        bloco alterado no meio do caminho gera erro 409. Aceita token de
        aplicação.
      requestBody:
        content:
          application/json:
            schema:
              description: Lote de operações sobre os blocos da página.
              type: object
              properties:
                base_revision:
                  type: integer
                  minimum: 0
                  description: Versão sobre a qual as operações foram montadas.
                operations:
                  type: array
                  description: Operações aplicadas em ordem (até 100).
                  items:
                    description: Operação sobre os blocos de primeiro nível.
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - replace_text
                          - replace_block
                          - insert_blocks
                          - delete_blocks
                        description: Tipo da operação.
                      ref:
                        type: string
                        description: >-
                          Bloco alvo, no formato `{índice}:{hash8}`. Obrigatório
                          em `replace_block`; opcional em `replace_text`.
                      after_ref:
                        type: string
                        description: >-
                          Em `insert_blocks`: insere depois deste bloco. Use
                          este campo ou `position`.
                      position:
                        type: string
                        enum:
                          - start
                          - end
                        description: >-
                          Em `insert_blocks`: insere no início ou no fim da
                          página. Use este campo ou `after_ref`.
                      refs:
                        type: array
                        description: 'Em `delete_blocks`: blocos a remover.'
                        items:
                          type: string
                          description: Bloco no formato `{índice}:{hash8}`.
                      markdown:
                        type: string
                        description: >-
                          Em `replace_block` e `insert_blocks`: conteúdo novo,
                          em Markdown.
                      old_text:
                        type: string
                        description: >-
                          Em `replace_text`: trecho a trocar; precisa aparecer
                          uma única vez.
                      new_text:
                        type: string
                        description: 'Em `replace_text`: texto que entra no lugar.'
                    required:
                      - type
              required:
                - base_revision
                - operations
              additionalProperties: false
            example:
              base_revision: 0
              operations:
                - type: insert_blocks
                  position: end
                  markdown: |-
                    ## Próximos passos

                    - Validar o cronograma
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Resposta com o conteúdo da página.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre `true` em caso de sucesso.
                  content:
                    type: object
                    description: Conteúdo da página.
                    properties:
                      thread_id:
                        type: integer
                        description: ID da página.
                      revision:
                        type: integer
                        description: >-
                          Número da versão do conteúdo; use como `base_revision`
                          na próxima gravação.
                      doc:
                        type: object
                        description: >-
                          Documento da página no formato JSON do editor (nó raiz
                          `doc`).
                        properties:
                          type:
                            type: string
                            description: Tipo do nó raiz; sempre `doc`.
                          content:
                            type: array
                            description: >-
                              Blocos de primeiro nível da página (parágrafos,
                              títulos, listas, tabelas, imagens…).
                            items:
                              description: >-
                                Bloco do documento, com `type` e, conforme o
                                tipo, `attrs`, `content` e `marks`.
                              type: object
                      updated_at:
                        type: string
                        description: Data da última gravação do conteúdo.
                        format: date-time
                      updated_by:
                        type: object
                        description: >-
                          Pessoa que gravou a versão; `null` quando a gravação
                          veio de uma aplicação.
                        properties:
                          id:
                            type: string
                            description: ID (UUID) do usuário.
                            format: uuid
                          name:
                            type: string
                            description: Nome do usuário.
              example:
                response: true
                content:
                  thread_id: 1202
                  revision: 4
                  doc:
                    type: doc
                    content:
                      - type: heading
                        attrs:
                          level: 2
                        content:
                          - type: text
                            text: Briefing
                      - type: paragraph
                        content:
                          - type: text
                            text: Implantação prevista para dezembro.
                  updated_at: '2026-11-09T14:22:05.000000Z'
                  updated_by: null
        '409':
          description: Conflito de bloco
          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.
                  refs:
                    type: array
                    description: Blocos que mudaram desde a leitura.
                    items:
                      type: string
                      description: Bloco no formato `{índice}:{hash8}`.
                  current_revision:
                    type: integer
                    description: Versão atual da página.
              example:
                response: false
                message: thread_content_block_conflict
                error: >-
                  The page changed since it was read: some referenced blocks no
                  longer exist with the same content. Read the page again and
                  retry.
                refs:
                  - 1:9f2c4a7b
                current_revision: 5
        '422':
          description: Operação inválida
          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.
                  context:
                    type: object
                    description: Detalhes do erro.
                    properties:
                      operation_index:
                        type: integer
                        description: Posição (a partir de 0) da operação com erro no lote.
              example:
                response: false
                message: thread_content_invalid_operation
                error: >-
                  Operation #0 is invalid: insert_blocks needs exactly one of
                  after_ref or position.
                context:
                  operation_index: 0
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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