---
title: "Obter publicação"
method: GET
path: "/api/management/form-publications/{form_publication}"
tags: ["form-publications"]
---

# Obter publicação

`GET /api/management/form-publications/{form_publication}`

Retorna a configuração completa de uma publicação, com o formulário publicado (só os campos respondíveis em link público), o modelo de projeto e o campo usado para nomear o projeto criado.

## Response `200`

Sucesso

- object — Publicação encontrada.
  - `response` boolean — Indicador de sucesso da requisição. Sempre true nas respostas bem-sucedidas.
  - `form_publication` object — Publicação de formulário.
    - `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.
    - `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.
    - `form` object — Formulário publicado.
      - `id` integer — ID do formulário.
      - `title` string — Título do formulário.
      - `frame_id` string, uuid — ID da conta dona do formulário.
      - `created_at` string, date-time — Data de criação do formulário.
      - `updated_at` string, date-time — Data da última alteração do formulário.
      - `deleted_at` string, date-time, nullable — Data de exclusão do formulário. Nulo quando ativo.
      - `edges` object[] — Campos respondíveis em link público, ordenados por index.
        - `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

- `404` — Não encontrado

## Changes

- **2026-09-22** `d8fb547e20a2` — 24 breaking, 24 warning, 20 info
  - the response property `form_publication/background_color` became nullable for the status `200`
  - the response property `form_publication/description` became nullable for the status `200`
  - the response property `form_publication/ends_at` became nullable for the status `200`
  - the response property `form_publication/redirect_url` became nullable for the status `200`
  - …64 more
- **2026-09-22** `d71b18b1685d` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/form-publications/:form_publication/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)