Modify an API request constraint's action

put

https://{hostname}/appsec/v1/configs/{configId}/versions/{versionNumber}/security-policies/{policyId}/api-request-constraints/{apiId}

Kona Site Defender, App & API Protector with the Advanced Security module Update what action to take when the API request constraint triggers. This operation modifies an individual API constraint action. To use this operation, run List all API request constraints and actions and pick an API from the response list. Use alert to record the trigger of the event, deny to block the request, or none to take no action. Currently the only field in the API Request Constraints object is action.

Path Params

configId

int64

required

A unique identifier for each configuration.

versionNumber

integer

required

A unique identifier for each version of a configuration.

policyId

string

required

A unique identifier for a security policy.

apiId

integer

required

A unique identifier for each API.

Query Params

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

action

string

enum

required

The action to assign to API request constraints, either alert, deny, or none. Use deny_custom_{custom_deny_id} to apply a custom action instead of Akamai's default. Run Modify a custom deny action to manage your custom deny actions. If the action is none, the rule is inactive in the policy.

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

URL

Response

Choose an example:

application/json

application/problem+json

200Successfully updated the API's action.

400Invalid. Client error, such as invalid or malformed input.

403Forbidden. You don't have permission to write to this resource.

404Not found. The security policy doesn't exist, doesn't carry application layer controls, or no rule with this ID is available for use in this policy.

500Internal server error. Something went wrong on our side. Try again in a few minutes or contact support if the error persists.