Delete an app setting value

DELETE

/app-setting-values/{id}

Permanently removes an app setting value record by its unique identifier. The record must belong to the authenticated entity. The caller must hold the appropriate ACL permission for the setting's component type: can_set_setting_values for entity-scoped values, or can_set_account_setting_values for account-scoped values. This action is irreversible — to restore a deleted value, it must be re-created via POST /app-setting-values.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

The app setting value was deleted successfully.

Bodyapplication/json

🟠401

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/app-setting-values/01HQZR2BKPFQ8MXJVT3G7LWN5' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "App setting value deleted successfully",
    "status": "success",
    "data": {
        "id": "01HQZR2BKPFQ8MXJVT3G7LWN5"
    }
}

Modified at 2026-08-06 16:06:15

Rotate an API key's secret

Retrieve an app setting value