Editar un formulario
Úsalo para guardar el contenido de un borrador de formulario —sus pantallas y preguntas— y ver en la respuesta qué falta corregir antes de publicarlo.
Permiso requerido: Contactos y conversaciones → Editar
Guarda la definición de un borrador. {id} es el id de la versión. Envía definition con screens (cada pantalla con id de texto y items; cada bloque con type, y las preguntas con name) y, si quieres, name y expected_updated_at. Una definición con la forma rota responde 422 con el error en su ruta. Lo incompleto (sin título, sin bloques, etiquetas vacías) se guarda y la respuesta trae en lint lo que falta corregir. Responde 409 PUBLISHED si la versión ya está publicada (crea otra con POST /forms/{id}/versions) y 409 STALE si expected_updated_at no es el último guardado. Responde 404 si no existe o no es de tu cuenta.
httpAuthorizationBearer <clave>id*stringId opaco: un texto que empieza con frv_. Se usa tal como llega; no se arma ni se interpreta.
^frv_[A-Za-z0-9]{23}$application/json- body
name?stringlength <= 120definition*expected_updated_at?string|nullOK
application/json- response
data*lint*array<unknown>curl -X PUT "https://example.com/forms/frv_Ath9bJ3RpAYPhnX0EfcLtHJ" \ -H "Content-Type: application/json" \ -d '{ "definition": { "screens": [ { "id": "string" } ] } }'{ "data": { "id": "frv_Ath9bJ3RpAYPhnX0EfcLtHJ", "family_id": "frm_AyJUGabeXUAk9dbBuWegw4B", "name": "string", "label": "string", "category": "string", "status": "string", "version": 0, "definition": [ null ], "fields": [ null ], "mapping": [ null ], "tag_rules": [ null ], "has_endpoint": true, "first_screen": "string", "first_screen_dynamic": true, "lint_errors_count": 0, "draft_id": "frv_Ath9bJ3RpAYPhnX0EfcLtHJ", "draft_version": 0, "sends": 0, "responses": 0, "meta_flow_id": "string", "flow_json": [ null ], "validation_errors": [ null ], "published_at": "string", "updated_at": "string" }, "lint": [ null ]}