{"id":4916,"date":"2025-10-10T08:00:00","date_gmt":"2025-10-10T05:00:00","guid":{"rendered":"https:\/\/support.withsecure.com\/?post_type=changelog&p=4916"},"modified":"2026-10-19T12:21:04","modified_gmt":"2026-10-19T09:21:04","slug":"elements-api-2025-10-10-update-2","status":"publish","type":"changelog","link":"https:\/\/support.withsecure.com\/en\/changelogs\/elements-api-2025-10-10-update-2\/","title":{"rendered":"Elements API – 2025-10-10 Update #2"},"content":{"rendered":"

Elements API: new “restart” remote operations<\/h2>\n

We have added two new remote operations to the Elements API device\u00a0operations endpoint that enable programmatic system\u00a0and agent restarts.<\/p>\n

Operations Overview<\/h3>\n

The new operations “restartSystem” and “restartProduct” are available via the POST<\/strong>\u00a0\/devices\/v1\/operations endpoint.<\/p>\n

New Operations<\/h3>\n

restartProduct<\/h4>\n

Restarts the WithSecure agent software\u00a0on a device without restarting the entire system.<\/p>\n

restartSystem<\/h4>\n

Restarts the entire\u00a0device (full system reboot).<\/p>\n

Batch\u00a0Capability<\/h3>\n

Both operations support batch execution on up to\u00a05 devices per request. <\/p>\n

Benefits<\/h3>\n
    \n
  1. Agent Troubleshooting: Restart\u00a0the WithSecure agent without disrupting the user’s work by avoiding a full system reboot.<\/li>\n
  2. Maintenance\u00a0Automation: Integrate system restarts into automated maintenance workflows\u00a0following software updates or configuration changes.<\/li>\n
  3. User\u00a0Communication: Provide advance notice to users with custom messages before system restarts, improving user experience.<\/li>\n
  4. Efficient Remediation: Quickly restart multiple devices as part of incident\u00a0response or troubleshooting procedures.<\/li>\n
  5. Granular Control: Choose between agent-only or full system restarts based on the specific troubleshooting or maintenance requirement.<\/li>\n
  6. Operation Tracking: Track restart operations using returned operation IDs to\u00a0verify execution on remote hosts.<\/li>\n<\/ol>\n

    Read more from the Elements API specification<\/a> under “Trigger remote operations on devices”.<\/p>\n","protected":false},"excerpt":{"rendered":"

    Elements API: new “restart” remote operations We have added two new remote operations to the Elements API device\u00a0operations endpoint that enable programmatic system\u00a0and agent restarts. Operations Overview The new operations…<\/p>\n","protected":false},"template":"","changelog_product":[128],"class_list":["post-4916","changelog","type-changelog","status-publish","hentry"],"acf":{"release_date":"20251010","version":"","source_system":"vanilla-import","source_foreign_id":"","import_hash":"c472b42036bd9d53da3ac8bbae6e9d9dab626cc3","vanilla_article_id":32639,"legacy_author":"ArtoV","vanilla_url":"https:\/\/community.withsecure.com\/changelogs-en\/kb\/articles\/32639-elements-api-2025-10-10-update-2","vanilla_category_id":170,"machine_translated":false},"_links":{"self":[{"href":"https:\/\/support.withsecure.com\/en\/wp-json\/wp\/v2\/changelog\/4916","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.withsecure.com\/en\/wp-json\/wp\/v2\/changelog"}],"about":[{"href":"https:\/\/support.withsecure.com\/en\/wp-json\/wp\/v2\/types\/changelog"}],"wp:attachment":[{"href":"https:\/\/support.withsecure.com\/en\/wp-json\/wp\/v2\/media?parent=4916"}],"wp:term":[{"taxonomy":"changelog_product","embeddable":true,"href":"https:\/\/support.withsecure.com\/en\/wp-json\/wp\/v2\/changelog_product?post=4916"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}