Delete Folder Icons

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "iFormBuilder V81 MCP server": {
    "url": "https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/mcp"
  }
}

Close
DELETE /profiles/{profile_id}/icons/{folder}

Deletes icons from an icon folder of the profile. Today the only folder is drawing_custom_icons, the custom icon set of the Drawing element.

Request body

A single { "url": ... } object or a JSON array of them, using the urls returned by GET or POST on this path.

Scope

Only the file name (the part after the last /) of each url is used. The object deleted is always {servername}/{profile_id}/{folder}/{file name}, so a url cannot reach another folder or another profile. A file name that does not exist in the folder is not reported as an error.

Storage failures

Each icon whose file storage fails to remove is reported, and its file is still served at its url. A single { "url": ... } object answers 502. An array answers per item: 207 when some icons were removed, 400 when none were.

Authorization

Restricted to internal client apps, the same as DELETE /profiles/{profile_id}/icons.

Headers

  • Authorization string

    e.g. Bearer {access_token}

Path parameters

  • profile_id string Required

    id of the profile

  • folder string Required

    name of the icon folder

    Value is drawing_custom_icons.

application/json
Body object | array[object] Required
One of:
Hide attribute Show attribute object
  • url string Required

Responses

  • 200 application/json

    OK - the icons were deleted. One url in the request returns a single IconOutcome; more than one returns an array, in request order.

    One of:

    per-icon outcome of an icons POST or DELETE request

    Hide attributes Show attributes object

    per-icon outcome of an icons POST or DELETE request

    • url string

      the icon's url; on POST, the url of the stored icon, on DELETE, the url exactly as submitted. Absent when the item failed.

    • error_message string

      present only when the item failed

  • 207 application/json

    Multi-Status - an array request where storage removed some icons and failed to remove others. The body has the same shape as 200; failed items carry error_message instead of url, and their files are still in storage.

    Hide response attributes Show response attributes object
    • url string

      the icon's url; on POST, the url of the stored icon, on DELETE, the url exactly as submitted. Absent when the item failed.

    • error_message string

      present only when the item failed

  • 400 application/json

    Bad Request - an item has no url, an empty url, or a url with no plain file name; nothing is deleted. Or an array request where storage failed to remove every icon; the body then has the same shape as 200, with an error_message on each item.

    One of:

    per-icon outcome of an icons POST or DELETE request

    Hide attributes Show attributes object

    per-icon outcome of an icons POST or DELETE request

    • url string

      the icon's url; on POST, the url of the stored icon, on DELETE, the url exactly as submitted. Absent when the item failed.

    • error_message string

      present only when the item failed

  • 401

    Unauthorized - missing or invalid bearer token.

  • 403

    Forbidden - the token is not from an internal client app, or profile_id is not the caller's own profile.

  • 404

    Not Found - folder is not an allowed icon folder, or profile_id does not exist.

  • 502 application/json

    Bad Gateway - a single-object request whose icon file storage failed to remove. The file is still in storage, and the body carries error_message.

    Hide response attributes Show response attributes object
    • url string

      the icon's url; on POST, the url of the stored icon, on DELETE, the url exactly as submitted. Absent when the item failed.

    • error_message string

      present only when the item failed

DELETE /profiles/{profile_id}/icons/{folder}
curl \
 --request DELETE 'https://api.iformbuilder.com/exzact/api/v81/[servername]/profiles/self/icons/drawing_custom_icons' \
 --header "Content-Type: application/json" \
 --header "Authorization: Bearer {access_token}" \
 --data '{
  "url": "https://zerion-iform-icons-example.s3.amazonaws.com/app/67890/drawing_custom_icons/field_17306240006721a2f0b1c3d.png"
}'
Request examples
{
  "url": "https://zerion-iform-icons-example.s3.amazonaws.com/app/67890/drawing_custom_icons/field_17306240006721a2f0b1c3d.png"
}
[
  {
    "url": "https://zerion-iform-icons-example.s3.amazonaws.com/app/67890/drawing_custom_icons/field_17306240006721a2f0b1c3d.png"
  },
  {
    "url": "https://zerion-iform-icons-example.s3.amazonaws.com/app/67890/drawing_custom_icons/field_17306240117721a2f0c4e5f.jpeg"
  }
]
Response examples (200)
{
  "url": "https://zerion-iform-icons-example.s3.amazonaws.com/app/67890/drawing_custom_icons/field_17306240006721a2f0b1c3d.png"
}
Response examples (207)
[
  {
    "url": "https://zerion-iform-icons-example.s3.amazonaws.com/app/67890/drawing_custom_icons/field_17306240006721a2f0b1c3d.png"
  },
  {
    "error_message": "Cannot delete icon file [field_17306240117721a2f0c4e5f.jpeg]"
  }
]
Response examples (400)
[
  {
    "error_message": "Cannot delete icon file [field_17306240006721a2f0b1c3d.png]"
  },
  {
    "error_message": "Cannot delete icon file [field_17306240117721a2f0c4e5f.jpeg]"
  }
]
Response examples (502)
{
  "error_message": "Cannot delete icon file [field_17306240006721a2f0b1c3d.png]"
}