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
}
Leads & Formulare
Formular aktualisieren
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
}
Aktualisiert den Namen, das Feldschema oder die Theme-Einstellungen eines Formulars.
Sowohl
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota und die Berechtigung LEAD_GENERATION_CAN_EDIT, gesendet als roher Authorization-Header-Wert — siehe die Übersicht über die Management API.PUT https://api.scanova.io/forms/{form_id}/
PATCH https://api.scanova.io/forms/{form_id}/
string
erforderlich
Die
form_id des Formulars. Unveränderlich — kann über diesen Endpunkt nicht geändert werden.string
Formularname.
object
Das Feldschema des Formulars — wird bei jeder Aktualisierung erneut gegen Scanovas Formular-Builder-JSON-Schema validiert. Fehlerhafte Daten geben
400 unter data zurück.integer
Die ID eines aktiven Themes, um die öffentliche Seite des Formulars zu gestalten.
object
Teilweise Theme-Token-Überschreibungen, die über
theme_id (oder das Standard-Theme) gelegt werden.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 als auch PATCH werden unterstützt. Dieser Endpunkt akzeptiert kein qr_id/qr_ids — verwenden Sie QR-Codes mit einem Formular verknüpfen, um zu ändern, welche QR-Codes angehängt sind. 404, wenn form_id diesem Konto nicht gehört.
Verwandte Themen
- Formular abrufen — aktuelle Werte vor dem Aktualisieren ansehen.
- QR-Codes mit einem Formular verknüpfen — die verknüpften QR-Codes ändern.
- Formular löschen — es dauerhaft entfernen.
- Übersicht über die Management API — das Authentifizierungsschema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
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.
Antwort
200
Form updated.
War diese Seite hilfreich?