> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base39.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Iniciar pesquisar

> Inicia a execução/pesquisa de um relatório



## OpenAPI

````yaml POST /reports/{id}/run
openapi: 3.1.0
info:
  title: Base39 API
  description: >-
    API da Base39 para inserir e consultar dados na base de forma simples e
    direta
  version: 1.0.0
  contact:
    name: Base39
    url: https://base39.com.br
    email: contato@base39.com.br
servers:
  - url: https://api.base39.com.br/v2
security:
  - OAuth2:
      - read
      - write
tags:
  - name: Records
    description: Operações relacionadas a registros de dados
  - name: Webhooks
    description: Endpoints para recebimento de dados via webhook
  - name: Reports
    description: Operações relacionadas a relatórios
  - name: Files
    description: Operações relacionadas a arquivos
paths:
  /reports/{id}/run:
    post:
      tags:
        - Reports
      description: Inicia a execução/pesquisa de um relatório
      operationId: runReport
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: ID do relatório
      responses:
        '200':
          description: Execução do relatório iniciada
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  target:
                    type: string
                  template:
                    type: string
                  status:
                    type: string
                    enum:
                      - pending
                      - processing
                      - completed
                      - error
                  runs:
                    type: array
                    items:
                      type: object
                      properties:
                        thread:
                          type: string
                        run:
                          type: string
                        createdAt:
                          type: string
                          format: date-time
                  sections:
                    type: array
                    description: Seções do relatório com conteúdo estruturado
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID único da seção
                        title:
                          type: string
                          description: Título da seção
                        status:
                          type: string
                          enum:
                            - queued
                            - processing
                            - done
                            - error
                          description: Status da seção
                        order:
                          type: integer
                          description: Ordem da seção no relatório
                        content:
                          type: string
                          description: Conteúdo em texto (estrutura atual)
                    example:
                      - id: sec_abc123
                        title: Resumo Executivo
                        status: done
                        order: 1
                        content: Este relatório apresenta uma análise completa...
                      - id: sec_def456
                        title: Análise Detalhada
                        status: processing
                        order: 2
                        content: null
                  createdAt:
                    type: string
                    format: date-time
                  updatedAt:
                    type: string
                    format: date-time
              example:
                id: rep_xyz789
                target: tgt_company123
                template: tpl_abc123def456
                status: processing
                runs:
                  - thread: thread_001
                    run: run_001
                    createdAt: '2025-01-15T10:35:00Z'
                sections:
                  - id: sec_abc123
                    title: Resumo Executivo
                    status: done
                    order: 1
                    content: >-
                      Este relatório apresenta uma análise completa da empresa.
                      Foram identificados 3 pontos principais de atenção...
                  - id: sec_def456
                    title: Análise Detalhada
                    status: processing
                    order: 2
                    content: null
                  - id: sec_ghi789
                    title: Conclusão
                    status: queued
                    order: 3
                    content: null
                createdAt: '2025-01-15T10:30:00Z'
                updatedAt: '2025-01-15T10:35:22Z'
components:
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.base39.com.br/oauth2/authorize
          tokenUrl: https://auth.base39.com.br/oauth2/token
          scopes:
            read: Permissão para ler dados
            write: Permissão para escrever dados

````