--- title: "Listar publicações" method: GET path: "/api/management/form-publications" tags: ["form-publications"] --- # Listar publicações `GET /api/management/form-publications` 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. ## Query parameters - `filter[title]` string - `filter[trashed]` string ## Response `200` Sucesso - object — Publicações da conta. - `response` boolean — Indicador de sucesso da requisição. Sempre true nas respostas bem-sucedidas. - `form_publications` object[] — Publicações encontradas. - `id` string, uuid — ID da publicação. - `title` string — Título exibido no formulário público. - `description` string, nullable — Descrição exibida dentro do formulário para quem responde. - `background_color` string, nullable — Cor de fundo do formulário público, em hexadecimal. Nulo usa a cor padrão. - `starts_at` string, date-time, nullable — Início da janela de publicação. Nulo: vale desde a criação. - `ends_at` string, date-time, nullable — Fim da janela de publicação. Nulo: não expira. - `redirect_url` string, nullable — Endereço para onde quem responde é levado após enviar. - `token` string, uuid — Token do link público do formulário. - `status` 'published' | 'unpublished' — Situação da publicação: published (link ativo) ou unpublished (link desligado). - `form_id` integer — ID do formulário publicado. - `frame_id` string, uuid — ID da conta dona da publicação. - `created_at` string, date-time — Data de criação da publicação. - `updated_at` string, date-time — Data da última alteração da publicação. - `deleted_at` string, date-time, nullable — Data de exclusão da publicação. Nulo quando ativa. - `create_project` union — Se cada resposta cria um projeto. Pode vir como 0/1 na leitura. - boolean - integer - `link_as_media` boolean — Se as respostas são gravadas no conteúdo do projeto criado. - `link_as_loose_form` boolean — Se as respostas são gravadas como formulário avulso do projeto criado. - `project_name` string, nullable — Nome fixo do projeto criado. Usado quando form_edge_id está vazio. - `form_edge_id` integer, nullable — ID do campo cuja resposta vira o nome do projeto criado. - `project_template_id` string, uuid, nullable — ID do modelo de projeto usado para criar o projeto. - `funnel_step_id` integer, nullable — ID da etapa em que o projeto criado é vinculado. - `type` 'publication' — Tipo do registro. Sempre publication neste endpoint. - `created_by` string, uuid, nullable — Campo reservado ao autor da publicação. Hoje não é preenchido. - `responses_count` integer — Quantidade de respostas recebidas para o formulário atualmente publicado. - `form` object — Formulário publicado (resumo). - `id` integer — ID do formulário. - `title` string — Título do formulário. - `project_template` object, nullable — Modelo de projeto usado na criação do projeto (objeto do projeto modelo). Nulo quando não há modelo. - `form_edge` object, nullable — Campo usado para nomear o projeto criado. Nulo quando não configurado. - `id` integer — ID do campo. - `type` 'short_text' | 'long_text' | 'rich_text' | 'attachment' | 'checkbox' | 'date' | 'date_and_time' | 'email' | 'phone' | 'select' | 'radio' | 'currency' | 'number' | 'link' | 'time' | 'matrix' — Tipo do campo. - `label` string — Rótulo do campo. - `index` integer — Posição do campo no formulário (ordem crescente). - `help_text` string, nullable — Texto de ajuda exibido junto ao campo. - `description` string, nullable — Descrição do campo. - `options` union — Opções do campo: lista de textos para select, radio e checkbox; objeto com rows/columns para matrix; lista vazia nos demais tipos. - string[] - object - `initial_value` union — Valor pré-preenchido do campo, no mesmo formato de uma resposta daquele tipo. - string - number - unknown[] - unknown - object - `required` boolean — Se o preenchimento é obrigatório. - `custom_validation` string, nullable — Expressão regular que a resposta precisa atender. - `conditional` unknown - `form_id` integer — ID do formulário ao qual o campo pertence. - `created_at` string, date-time — Data de criação do campo. - `updated_at` string, date-time — Data da última alteração do campo. - `deleted_at` string, date-time, nullable — Data em que o campo foi arquivado. Nulo quando ativo. - `is_multiple` boolean — Se o campo aceita mais de um valor (ex.: vários links). - `logical_operator` 'and' | 'or' — Como as regras condicionais do campo se combinam. - `is_migrated` boolean — Marcador interno de migração de dados. Pode ser ignorado. - `conditional_action` 'show' | 'hide' | 'null', nullable — 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. ## Other responses - `400` — Filtro inválido ## Changes - **2026-09-22** `d8fb547e20a2` — 17 breaking, 4 warning, 20 info - the response property `form_publications/items/background_color` became nullable for the status `200` - the response property `form_publications/items/description` became nullable for the status `200` - the response property `form_publications/items/ends_at` became nullable for the status `200` - the response property `form_publications/items/redirect_url` became nullable for the status `200` - …37 more - **2026-09-22** `d71b18b1685d` — 4 info - added the new optional `query` request parameter `filter[title]` - added the new optional `query` request parameter `filter[trashed]` - added the media type `application/json` for the response with the status `200` - added the non-success response with the status `400` [Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/form-publications/get.md) --- [API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d7bda7d32f67?raw)