Update an application

put

https://{hostname}/appsec/v1/fai-configurations/{faiConfigId}/applications/{userApplicationId}

This updates an existing application on an API type configuration. The request replaces the application in full, so send every value you want it to keep: an omitted description is removed and omitted tags are cleared.

Path Params

faiConfigId

string

required

^[0-9]+$

Identifier for the FAI configuration.

userApplicationId

string

required

Unique identifier for the user application.

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

Represents an application registered on an API type Firewall for AI configuration.

applicationName

string

required

length between 1 and 255

Display name of the application. Must be unique within the configuration.

description

string

length between 1 and 255

Description of the application.

200Application updated successfully.

400Bad request. The request isn't valid, for example an id that isn't a number, a missing or out-of-range field, a value that isn't allowed, or rule settings that conflict. The detail names the field, the value sent, and what to change.

401Unauthorized.

403Forbidden. You don't have the access this operation needs, or your account isn't entitled to a feature the request uses, such as a rule, the MODIFY action, or languages. The detail says which access or entitlement to ask for.

404Not found. A resource in the URL doesn't exist: the configuration, version, custom PII type, application, access key, or activation. The detail names the missing id and where to find valid ones.

409Conflict. The application conflicts with the configuration's current state. Either the configuration has no active version yet, it already has the maximum number of applications, or another application on it already uses that name.

500Internal server error. Something failed on Akamai's side. Try again later. If it keeps happening, contact Akamai support with the instance value.