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
}
Prospects et formulaires
Mettre à jour un formulaire
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
}
Met à jour le nom, le schéma de champs ou les paramètres de thème d’un formulaire.
Nécessite une clé d’API de gestion avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) et la permission LEAD_GENERATION_CAN_EDIT, envoyée comme valeur brute de l’en-tête Authorization — voir la présentation de l’API de gestion.PUT https://api.scanova.io/forms/{form_id}/
PATCH https://api.scanova.io/forms/{form_id}/
string
requis
Le
form_id du formulaire. Immuable — ne peut pas être modifié via cet endpoint.string
Nom du formulaire.
object
Le schéma de champs du formulaire — revalidé par rapport au schéma JSON du générateur de formulaires de Scanova à chaque mise à jour. Des données mal formées renvoient
400 sous data.integer
L’id d’un thème actif pour styliser la page publique du formulaire.
object
Surcharges partielles de jetons de thème superposées à
theme_id (ou au thème par défaut).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 et PATCH sont tous deux pris en charge. Cet endpoint n’accepte pas qr_id/qr_ids — utilisez Lier des codes QR à un formulaire pour modifier les codes QR rattachés. 404 si form_id n’appartient pas à ce compte.
Voir aussi
- Récupérer un formulaire — voir les valeurs actuelles avant la mise à jour.
- Lier des codes QR à un formulaire — modifier les codes QR liés.
- Supprimer un formulaire — le supprimer définitivement.
- Présentation de l’API de gestion — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
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.
Réponse
200
Form updated.
Cette page vous a-t-elle été utile ?