Deletes public links, each found by id, by page_id, or by both. Send one object or an array of objects.
Authorization
The same rule as Update Public Links: 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 deleted, so one link the caller cannot modify fails the whole request with 403.
Responses
-
OK - every link was deleted. A single object in the body answers a single
{id}; an array answers an array in request order. -
Multi-Status - some links were deleted and some failed. Each failed item carries
error_message. -
Bad Request - every item failed (for example no link matches its
idorpage_id, or public links are not enabled on this server). -
Unauthorized - missing or invalid bearer token.
-
Forbidden - the caller cannot modify the form of one of the links (see Authorization), or
profile_idis not the caller's own profile. Nothing is deleted.
curl \
--request DELETE 'https://api.iformbuilder.com/exzact/api/v81/[servername]/profiles/self/public_links' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer {access_token}" \
--data '{
"id": 41
}'
{
"id": 41
}
{
"id": 41
}
[
{
"id": 42,
"error_message": "string"
}
]
{
"id": 42,
"error_message": "string"
}
[
{
"id": 42,
"error_message": "string"
}
]
{
"error_message": "string"
}