Referencia (endpoints)Formularios

Crear una versión de un formulario

Úsalo para cambiar un formulario ya publicado: crea un borrador nuevo a partir de esa versión, que editas y publicas sin cambiar el form_id con el que lo mandas.

POST
/forms/{id}/versions

Permiso requerido: Contactos y conversaciones → Editar

Crea la versión siguiente de un formulario publicado, como borrador, para poder cambiarlo. {id} es el id de la versión desde la que partes. Responde 201 con la versión nueva, o 200 con created: false si el formulario ya tenía un borrador (ese borrador es la respuesta). Responde 404 si la versión 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 de la respuesta

OK

application/json
  1. response
data*
created*boolean
lint*array<unknown>
numbers*array<any>
Elementos1 <= items <= 1
curl -X POST "https://example.com/forms/frv_Ath9bJ3RpAYPhnX0EfcLtHJ/versions"
{  "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"  },  "created": true,  "lint": [    null  ],  "numbers": [    {      "device_id": null,      "primary": true,      "status": "string",      "error": "string"    }  ]}

Esto es lo que se copia para tu IA

Cargando…