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
}
潜在客户与表单
更新表单
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
}
更新表单的名称、字段架构或主题设置。
同时支持
需要具有
MANAGEMENT_API(或 MANAGEMENT_API_SANDBOX)配额和 LEAD_GENERATION_CAN_EDIT 权限的管理 API 密钥,作为原始 Authorization 标头值发送 —— 参见管理 API 概述。PUT https://api.scanova.io/forms/{form_id}/
PATCH https://api.scanova.io/forms/{form_id}/
string
必填
表单的
form_id。不可变 —— 无法通过此端点更改。string
表单名称。
object
表单的字段架构 —— 每次更新时都会重新根据 Scanova 表单构建器的 JSON 架构进行验证。格式错误的数据会在
data 下返回 400。integer
用于设计表单公开页面样式的有效主题 ID。
object
叠加在
theme_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
}
PUT 和 PATCH。此端点不接受 qr_id/qr_ids —— 使用将 QR 码链接到表单来更改附加的 QR 码。如果 form_id 不属于此账户,则返回 404。
相关内容
- 获取表单 —— 更新前查看当前值。
- 将 QR 码链接到表单 —— 更改已链接的 QR 码。
- 删除表单 —— 永久删除它。
- 管理 API 概述 —— 此端点所属的身份验证方案和配额体系。
授权
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.
响应
200
Form updated.
此页面对您有帮助吗?