---
title: "Salvar formulário"
method: POST
path: "/api/management/save-form"
tags: ["forms"]
---

# Salvar formulário

`POST /api/management/save-form`

Cria um formulário ou, quando `id` é enviado, atualiza o título e os campos de um existente. A lista `edges` é sempre a definição completa: campo existente que não vier no payload é removido definitivamente. Tipos de campo e lógica condicional estão em [Criar um formulário](https://docs.olie.ai/guides/forms/creating-forms).

## Request body

- object
  - `id` unknown
  - `title` string
  - `edges` object[]
    - `id` string
    - `label` string
    - `type` string
    - `index` integer
    - `required` boolean
    - `help_text` string
    - `description` unknown
    - `custom_validation` unknown

## Response `200`

Sucesso

- object
  - `response` boolean
  - `form` object
    - `title` string
    - `frame_id` string
    - `updated_at` string, date-time
    - `created_at` string, date-time
    - `id` integer
    - `edges` object[]
      - `id` integer
      - `type` string
      - `label` string
      - `index` integer
      - `help_text` string
      - `description` unknown
      - `options` unknown[]
        - unknown
      - `initial_value` unknown
      - `required` boolean
      - `custom_validation` unknown
      - `conditional` unknown
      - `form_id` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `deleted_at` unknown
      - `is_multiple` boolean
      - `logical_operator` string
      - `is_migrated` boolean
      - `conditional_action` unknown
      - `conditionals` unknown[]
        - unknown

## Other responses

- `422` — Validação falhou

## Changes

- **2026-09-22** `b43a04f35145` — 3 info
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/save-form/post.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/b43a04f35145?raw)