Cisco
Login
Search
Software Secure Firewall Threat Defense
Platform Secure Firewall Threat Defense Virtual
Activity Onboard

Configuring FDM-Managed Devices Create a REST API Macro About FTD REST API Macros Create a REST API Macro Create a REST API Macro from a New Command

Last updated: Jun 09, 2025

Create a REST API Macro from a New Command

Procedure

1

Before you create a REST API macro, test the command in Security Cloud Control's REST API Interface to make sure the command syntax is correct and it returns reliable results.


 

You can only create macros for a device once it has been onboarded to Security Cloud Control.
2

Select an FDM-managed device you want to manage using the REST API, and in Device Actions on the right, click API Tool.
3

Click the REST API macro favorites star to see what macros already exist.
4

Click the plus button .
5

Give the macro a unique name. Provide a description and notes for the REST API macro if you wish.
6

Select a Request Method and enter the endpoint URL in the Request Endpoint field. See Cisco Firepower Threat Defense REST API Guide for detailed information.

7

Replace the parts of the command that you would want to modify, when you run the command, with a parameter name surrounded by curly braces.
8

Click OK. The macro you create is available for use on all the devices of that type, not just the one you initially specified.

To run the command see, Run a REST API Macro.
Previous topic Create a REST API Macro Next topic Create a REST API Macro from History or from an Existing REST API Macro