Referencia (endpoints)Formularios

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.

PUT
/forms/{id}

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.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

id*string

Id opaco: un texto que empieza con frv_. Se usa tal como llega; no se arma ni se interpreta.

Patrón^frv_[A-Za-z0-9]{23}$

Cuerpo del pedido

application/json
  1. body
name?string
Largolength <= 120
definition*
expected_updated_at?string|null

Cuerpo de la respuesta

OK

application/json
  1. 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  ]}

Esto es lo que se copia para tu IA

Cargando…