Updates public links, each found by id, by page_id, or by both. Fields left out keep their value.
password: a non-empty string sets a new password (stored RSA-encrypted). "" removes the password, so the link no longer asks for one. null or leaving password out keeps the current password.
Authorization
The same rule as Create Public Links, applied to the form each link belongs to: SERVER users any form; COMPANY users their own profile's non-shared forms; BASIC users with the Form Builder role only forms they created. An internal API client gets no exemption. Every link is checked before anything is written, so one link the caller cannot modify fails the whole request with 403.
Responses
-
OK - every item was updated. The body is always an array, in request order.
-
Multi-Status - some items were updated and some failed. Each failed item carries
error_message. -
Bad Request - every item failed (for example neither
idnorpage_id, no link matches them, or public links are not enabled on this server). The body is the same array, witherror_messageon each item. -
Unauthorized - missing or invalid bearer token.
-
Forbidden - the caller cannot modify the form of one of the links in the body (see Authorization), or
profile_idis not the caller's own profile. Nothing is updated.
curl \
--request PUT 'https://api.iformbuilder.com/exzact/api/v80/[servername]/profiles/self/public_links' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer {access_token}" \
--data '{
"id": 41,
"password": "n3w-pass"
}'
{
"id": 41,
"password": "n3w-pass"
}
{
"id": 41,
"password": ""
}
{
"page_id": 290749032,
"is_disabled": true
}
[
{
"id": 41
}
]
[
{
"id": 42,
"error_message": "string"
}
]
[
{
"id": 42,
"error_message": "string"
}
]
{
"error_message": "string"
}