curl --request PATCH \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "name": "Trade Show Booth Signup" }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Trade Show Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 1,
"linked_qrs": [],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
Clientes potenciales y formularios
Actualizar un formulario
PATCH /forms//
PATCH
/
forms
/
{form_id}
/
curl --request PATCH \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "name": "Trade Show Booth Signup" }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Trade Show Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 1,
"linked_qrs": [],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
Actualiza el nombre, el esquema de campos o la configuración de tema de un formulario.
Se admiten tanto
Requiere una clave de API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX) y el permiso LEAD_GENERATION_CAN_EDIT, enviada como el valor sin procesar del encabezado Authorization — consulte el resumen de la API de gestión.PUT https://api.scanova.io/forms/{form_id}/
PATCH https://api.scanova.io/forms/{form_id}/
string
requerido
El
form_id del formulario. Inmutable — no se puede cambiar mediante este endpoint.string
Nombre del formulario.
object
El esquema de campos del formulario — se vuelve a validar contra el esquema JSON del generador de formularios de Scanova en cada actualización. Los datos con formato incorrecto devuelven
400 bajo data.integer
El id de un tema activo para diseñar la página pública del formulario.
object
Anulaciones parciales de tokens de tema superpuestas a
theme_id (o al tema predeterminado).curl --request PATCH \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "name": "Trade Show Booth Signup" }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Trade Show Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 1,
"linked_qrs": [],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
PUT como PATCH. Este endpoint no acepta qr_id/qr_ids — use Vincular códigos QR a un formulario para cambiar qué códigos QR están adjuntos. 404 si form_id no pertenece a esta cuenta.
Relacionado
- Obtener un formulario — ver los valores actuales antes de actualizar.
- Vincular códigos QR a un formulario — cambiar los códigos QR vinculados.
- Eliminar un formulario — eliminarlo permanentemente.
- Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas a la que pertenece este endpoint.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Respuesta
200
Form updated.
¿Esta página le ayudó?