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

# Criar uma página

> Cria uma [página](https://docs.olie.ai/guides/notebook/pages#criando-páginas) no Caderno, com o conteúdo vazio (versão 1). Envie `parent_id` para criar uma subpágina. Aceita token de aplicação.



## OpenAPI

````yaml /api-reference/openapi.json post /api/management/forums/{forum_id}/threads
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:
    parameters:
      - name: forum_id
        in: path
        required: true
        description: ID (UUID) do Caderno.
        schema:
          type: string
        example: ''
    post:
      tags:
        - forums
      summary: Criar uma página
      description: >-
        Cria uma
        [página](https://docs.olie.ai/guides/notebook/pages#criando-páginas) no
        Caderno, com o conteúdo vazio (versão 1). Envie `parent_id` para criar
        uma subpágina. Aceita token de aplicação.
      requestBody:
        content:
          application/json:
            schema:
              description: Dados da nova página.
              type: object
              properties:
                name:
                  type: string
                  description: Nome da página.
                order:
                  type: integer
                  minimum: 0
                  description: Posição da página entre as irmãs (0 ou mais).
                parent_id:
                  type: integer
                  description: >-
                    ID da página pai, para criar uma subpágina. Se não existir
                    neste Caderno, a página é criada na raiz.
              required:
                - name
                - order
              additionalProperties: false
            example:
              name: Escopo e entregas
              order: 0
              parent_id: null
      responses:
        '201':
          description: Criado
          content:
            application/json:
              schema:
                description: Resposta com a página criada.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre `true` em caso de sucesso.
                  thread:
                    type: object
                    description: Página criada.
                    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).
                      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
              example:
                response: true
                thread:
                  name: Escopo e entregas
                  order: 0
                  forum_id: 3f6b2a1c-9d8e-4f7a-b6c5-d4e3f2a1b0c9
                  parent_id: null
                  updated_at: '2026-11-09T14:22:05.000000Z'
                  created_at: '2026-11-09T14:22:05.000000Z'
                  id: 1204
        '403':
          description: Sem permissão
          content:
            application/json:
              schema:
                description: Resposta de erro.
                type: object
                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.
                  permission:
                    type: string
                    description: Permissão que faltou ao usuário.
              example:
                response: false
                message: permission_required
                error: An permission is required to that action
                permission: projects.edit.8a1f2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c
        '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: Validação falhou
          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.
                  validation:
                    type: object
                    description: >-
                      Erros por campo: cada chave é um campo e o valor, a lista
                      de mensagens.
                    additionalProperties:
                      type: array
                      description: Mensagens de erro do campo.
                      items:
                        type: string
                        description: Mensagem de erro.
              example:
                response: false
                message: validation_errors
                error: O campo order é obrigatório.
                validation:
                  order:
                    - O campo order é obrigatório.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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