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

# Listar publicações

> Lista todas as [publicações de formulário](https://docs.olie.ai/guides/forms/public-forms) da conta, sem paginação, com o total de respostas de cada uma. [Solicitações](https://docs.olie.ai/guides/forms/requests) não aparecem aqui.



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/form-publications
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/form-publications:
    get:
      tags:
        - form-publications
      summary: Listar publicações
      description: >-
        Lista todas as [publicações de
        formulário](https://docs.olie.ai/guides/forms/public-forms) da conta,
        sem paginação, com o total de respostas de cada uma.
        [Solicitações](https://docs.olie.ai/guides/forms/requests) não aparecem
        aqui.
      operationId: listarPublicaEsDeFormulRios
      parameters:
        - name: filter[title]
          in: query
          description: Busca parcial no título da publicação.
          schema:
            type: string
          example: ''
        - name: filter[trashed]
          in: query
          description: >-
            Publicações excluídas: `with` (ativas e excluídas) ou `only` (só
            excluídas). Omita para trazer só as ativas.
          schema:
            type: string
          example: ''
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: object
                description: Publicações da conta.
                properties:
                  response:
                    type: boolean
                    description: >-
                      Indicador de sucesso da requisição. Sempre true nas
                      respostas bem-sucedidas.
                  form_publications:
                    type: array
                    description: Publicações encontradas.
                    items:
                      type: object
                      description: Publicação de formulário.
                      properties:
                        id:
                          type: string
                          description: ID da publicação.
                          format: uuid
                        title:
                          type: string
                          description: Título exibido no formulário público.
                        description:
                          type: string
                          description: >-
                            Descrição exibida dentro do formulário para quem
                            responde.
                          nullable: true
                        background_color:
                          type: string
                          description: >-
                            Cor de fundo do formulário público, em hexadecimal.
                            Nulo usa a cor padrão.
                          nullable: true
                        starts_at:
                          type: string
                          description: >-
                            Início da janela de publicação. Nulo: vale desde a
                            criação.
                          format: date-time
                          nullable: true
                        ends_at:
                          type: string
                          description: 'Fim da janela de publicação. Nulo: não expira.'
                          format: date-time
                          nullable: true
                        redirect_url:
                          type: string
                          description: >-
                            Endereço para onde quem responde é levado após
                            enviar.
                          nullable: true
                        token:
                          type: string
                          description: Token do link público do formulário.
                          format: uuid
                        status:
                          type: string
                          description: >-
                            Situação da publicação: published (link ativo) ou
                            unpublished (link desligado).
                          enum:
                            - published
                            - unpublished
                        form_id:
                          type: integer
                          description: ID do formulário publicado.
                        frame_id:
                          type: string
                          description: ID da conta dona da publicação.
                          format: uuid
                        created_at:
                          type: string
                          description: Data de criação da publicação.
                          format: date-time
                        updated_at:
                          type: string
                          description: Data da última alteração da publicação.
                          format: date-time
                        deleted_at:
                          type: string
                          description: Data de exclusão da publicação. Nulo quando ativa.
                          format: date-time
                          nullable: true
                        create_project:
                          description: >-
                            Se cada resposta cria um projeto. Pode vir como 0/1
                            na leitura.
                          anyOf:
                            - type: boolean
                            - type: integer
                        link_as_media:
                          type: boolean
                          description: >-
                            Se as respostas são gravadas no conteúdo do projeto
                            criado.
                        link_as_loose_form:
                          type: boolean
                          description: >-
                            Se as respostas são gravadas como formulário avulso
                            do projeto criado.
                        project_name:
                          type: string
                          description: >-
                            Nome fixo do projeto criado. Usado quando
                            form_edge_id está vazio.
                          nullable: true
                        form_edge_id:
                          type: integer
                          description: >-
                            ID do campo cuja resposta vira o nome do projeto
                            criado.
                          nullable: true
                        project_template_id:
                          type: string
                          description: ID do modelo de projeto usado para criar o projeto.
                          format: uuid
                          nullable: true
                        funnel_step_id:
                          type: integer
                          description: ID da etapa em que o projeto criado é vinculado.
                          nullable: true
                        type:
                          type: string
                          description: Tipo do registro. Sempre publication neste endpoint.
                          enum:
                            - publication
                        created_by:
                          type: string
                          description: >-
                            Campo reservado ao autor da publicação. Hoje não é
                            preenchido.
                          format: uuid
                          nullable: true
                        responses_count:
                          type: integer
                          description: >-
                            Quantidade de respostas recebidas para o formulário
                            atualmente publicado.
                        form:
                          type: object
                          description: Formulário publicado (resumo).
                          properties:
                            id:
                              type: integer
                              description: ID do formulário.
                            title:
                              type: string
                              description: Título do formulário.
                        project_template:
                          type: object
                          description: >-
                            Modelo de projeto usado na criação do projeto
                            (objeto do projeto modelo). Nulo quando não há
                            modelo.
                          nullable: true
                        form_edge:
                          type: object
                          description: >-
                            Campo usado para nomear o projeto criado. Nulo
                            quando não configurado.
                          properties:
                            id:
                              type: integer
                              description: ID do campo.
                            type:
                              type: string
                              description: Tipo do campo.
                              enum:
                                - short_text
                                - long_text
                                - rich_text
                                - attachment
                                - checkbox
                                - date
                                - date_and_time
                                - email
                                - phone
                                - select
                                - radio
                                - currency
                                - number
                                - link
                                - time
                                - matrix
                            label:
                              type: string
                              description: Rótulo do campo.
                            index:
                              type: integer
                              description: >-
                                Posição do campo no formulário (ordem
                                crescente).
                            help_text:
                              type: string
                              description: Texto de ajuda exibido junto ao campo.
                              nullable: true
                            description:
                              type: string
                              description: Descrição do campo.
                              nullable: true
                            options:
                              description: >-
                                Opções do campo: lista de textos para select,
                                radio e checkbox; objeto com rows/columns para
                                matrix; lista vazia nos demais tipos.
                              items:
                                type: string
                                description: Texto de uma opção.
                              anyOf:
                                - type: array
                                  items: {}
                                - type: object
                            initial_value:
                              description: >-
                                Valor pré-preenchido do campo, no mesmo formato
                                de uma resposta daquele tipo.
                              nullable: true
                              anyOf:
                                - type: string
                                - type: number
                                - type: array
                                  items: {}
                                - type: object
                            required:
                              type: boolean
                              description: Se o preenchimento é obrigatório.
                            custom_validation:
                              type: string
                              description: >-
                                Expressão regular que a resposta precisa
                                atender.
                              nullable: true
                            conditional:
                              description: >-
                                Campo legado, sempre nulo. As regras ficam em
                                conditionals.
                              nullable: true
                            form_id:
                              type: integer
                              description: ID do formulário ao qual o campo pertence.
                            created_at:
                              type: string
                              description: Data de criação do campo.
                              format: date-time
                            updated_at:
                              type: string
                              description: Data da última alteração do campo.
                              format: date-time
                            deleted_at:
                              type: string
                              description: >-
                                Data em que o campo foi arquivado. Nulo quando
                                ativo.
                              format: date-time
                              nullable: true
                            is_multiple:
                              type: boolean
                              description: >-
                                Se o campo aceita mais de um valor (ex.: vários
                                links).
                            logical_operator:
                              type: string
                              description: >-
                                Como as regras condicionais do campo se
                                combinam.
                              enum:
                                - and
                                - or
                            is_migrated:
                              type: boolean
                              description: >-
                                Marcador interno de migração de dados. Pode ser
                                ignorado.
                            conditional_action:
                              type: string
                              description: >-
                                O que acontece com o campo quando as regras são
                                atendidas: show (exibe) ou hide (oculta). Nulo
                                quando não há lógica condicional.
                              enum:
                                - show
                                - hide
                                - null
                              nullable: true
                          nullable: true
              example:
                response: true
                form_publications:
                  - id: 01a0cb22-5af9-7290-a243-736378cb5350
                    title: Inscrição - Workshop de Processos
                    description: Preencha para garantir sua vaga.
                    background_color: '#1E40AF'
                    starts_at: null
                    ends_at: '2026-12-31 23:59:59'
                    redirect_url: https://exemplo.com.br/obrigado
                    token: e867fd11-bf8d-4b10-b8a0-77deae294392
                    status: published
                    form_id: 70
                    frame_id: 01a0252b-d865-71af-a0a2-d4e168d1ffe5
                    created_at: '2026-09-22T22:00:21.000000Z'
                    updated_at: '2026-09-22T22:01:18.000000Z'
                    deleted_at: null
                    create_project: 0
                    link_as_media: false
                    link_as_loose_form: false
                    project_name: null
                    form_edge_id: null
                    project_template_id: null
                    funnel_step_id: null
                    type: publication
                    created_by: null
                    responses_count: 1
                    form:
                      id: 70
                      title: Doc Postman - Inscrição em evento
                    project_template: null
                    form_edge: null
        '400':
          description: Filtro inválido
          content:
            application/json:
              schema:
                type: object
                description: Resposta de erro.
                properties:
                  response:
                    type: boolean
                    description: Indicador de sucesso da requisição. Sempre false em erros.
                  message:
                    type: string
                    description: >-
                      Código do erro para tratamento no cliente:
                      invalid_filter_query.
                  error:
                    type: string
                    description: Descrição legível do erro.
                  allowed_filters:
                    type: array
                    description: Filtros aceitos.
                    items:
                      type: string
                      description: Nome de um filtro aceito.
                  unknown_filters:
                    description: Filtros enviados que não são aceitos.
                    additionalProperties:
                      type: string
                      description: Nome do filtro recusado.
                    items:
                      type: string
                      description: Nome do filtro recusado.
                    anyOf:
                      - type: object
                      - type: array
                        items: {}
              example:
                response: false
                message: invalid_filter_query
                error: >-
                  Requested filter(s) `foo` are not allowed. Allowed filter(s)
                  are `title, trashed`.
                allowed_filters:
                  - title
                  - trashed
                unknown_filters:
                  '1': foo
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````