General - Configuration Settings Delete.adoc

General - Configuration Settings Delete

The /api/edge/delete.json endpoint allows you to delete a specific part of the device’s configuration.

It does not support a HTTP GET.

This method is CSRF protected so also requires a X-CSRF-TOKEN (see Sensitive Requests (CSRF Protection)).

Table of Contents

• Request
• Response
  • Root
  • status Object
• Examples
  • Custom Attribute Successful Deletion

Request

A HTTP POST to /api/edge/delete.json with the JSON configuration attributes to delete as the request content.

Response

Root

Name	Type	Values	Description
DELETE	Object	status object	An object that contains status values for the deletion request.
SESSION_ID	String	A session ID	The authorisation string for this session that confirms the user is correctly authenticated.
GET	String	JSON configuration	The parent section of the deleted value after the deletion.
COMMIT	Object	status object	An object that contains status values for the configuration commit request.
SAVE	Object	status object	An object that contains status values for the configuration save request.
success	Boolean	true or false	Whether the API request was successful.

status Object

Name	Type	Values	Description
failure	String	A boolean encapsulated in a string (e.g. "0" or "1")	Whether the operation failed.
success	String	A boolean encapsulated in a string (e.g. "0" or "1")	Whether the configuration settings delete operation was successful.

Examples

Custom Attribute Successful Deletion

POST /api/edge/delete.json Request

{"custom-attribute":{"hi":null}}

POST /api/edge/delete.json Response

{"DELETE": {"failure": "0", "success": "1"}, "SESSION_ID": "742dfcc13b8d449aa36a4a1847bfcef7", "GET": {"custom-attribute": ""}, "COMMIT": {"failure": "0", "success": "1"}, "SAVE": {"success": "1"}, "success": true}