Delete a device

Deletes the specified device from AFA.

Resource Name:

/api/v1/devices/{device-name}

Request Method: DELETE

Request URL Parameters:

Element

Type

Description

device-name

Mandatory

String

Name of the device you want to delete.

Note: This is not the name displayed in the tree. Get this name using another API.

For details, see Get details for a specified device or Get a list of devices.

Response:

Code

Description

200

Operation completed successfully

400

Bad request. This response may include the following error message:

Not Found. Relevant when editing a device configuration, if the specified device is not found in AFA.

401

Unauthorized

403

Non-admin user

Request example

curl --location --request DELETE 'https://1.1.1.1/afa/api/v1/devices/10_20_13_1' \ --header 'Content-Type: application/json' \ --header 'Accept: */*' \ --header 'Cookie: PHPSESSID=7qdbj3us6488i7hvfh2fb817f1'

Response example

{

 "httpStatus": "200",
  "message": "Successfully deleted the device: fw_10_20_13_1",
  "LogData": "",
  "fw_name": "",
  "syslog_restart_needed": false,
  "not_supported_audit_from_clm": false,
  "set_user_permissions": false
}