openapi: 3.0.1 info: title: Cloud Application Security API license: name: Imperva License Agreement. url: http://www.imperva.com/other/license_agreement.asp version: '1.0' externalDocs: description: Cloud Application Security API Reference url: https://docs.imperva.com/bundle/cloud-application-security/page/api/api.htm servers: - url: https://my.imperva.com description: Imperva API server variables: {} security: - api_key: [] - api_id: [] tags: - name: Account Management description: Add, delete, and modify accounts. Get account details. - name: Site Management description: Add, remove, and update sites. - name: DDoS Protection for Individual IPs description: Manage IP Protection over TCP/IP settings. - name: DDoS for Networks Test Alerts description: Generate dummy notifications to test system alerts. - name: Traffic Statistics and Logs description: Retrieve traffic statistics and logs for sites or accounts. - name: Login Protect description: Provision Login Protect users and configure protected pages. - name: Integrations description: Implement integrations with the Imperva service. paths: /api/prov/v1/accounts/gettoken: post: tags: - Account Management summary: Get account login token description: 'Tokens are used instead of user/password based authentication to log in to the Imperva Cloud Security Console. Use this operation to generate a token for an account. The token is valid for 15 minutes.' operationId: getToken parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 - name: partner_id in: query description: Numeric identifier of the parent id to operate on schema: type: string example: 15 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApiResultGetSsoToken' /api/prov/v1/accounts/list: post: tags: - Account Management summary: List managed accounts description: Available for Reseller accounts only.
Use this operation to get the list of accounts that are managed by account of the API client (the parent account). operationId: listAccounts parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 - name: page_size in: query description: 'The number of objects to return in the response.
Default: 50
Maximum: 100' schema: type: string example: 75 - name: page_num in: query description: 'The page to return starting from 0. Default: ''0' schema: type: string example: 0 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApiResultListUsers' /api/prov/v1/subaccounts/add: post: tags: - Account Management summary: Add a new sub account description: Use this operation to add a new sub account to be managed by the account of the API client (the parent account). operationId: addSubAccount parameters: - name: sub_account_name in: query description: The name of the sub account. required: true schema: type: string example: My Sub Account - name: parent_id in: query description: The newly created account's parent id. If not specified, the invoking account will be assigned as the parent account. schema: type: integer format: int64 example: 10 - name: ref_id in: query description: Customer specific identifier for this operation. schema: type: string example: 1 - name: log_level in: query description: 'Sets the log reporting level for the site.
Possible values: full, security, none, default
Available only for customers that purchased the Logs Integration SKU.' schema: type: string example: full - name: logs_account_id in: query description: Numeric identifier of the account that purchased the logs integration SKU and which collects the logs.
If not specified, operation will be performed on the account identified by the authentication parameters.
Available only for customers that purchased the Logs Integration SKU. schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account_id
9415 - Operation not allowed
1015 - Maximum number of SubAccounts reached
1003 - Plan ID invalid
1010 - Account exists content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSubAccountStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/listSubAccounts: post: tags: - Account Management summary: List account's sub accounts description: Use this operation to get a list of sub accounts that are managed by the account of the API client (the parent account). operationId: listSubAccounts parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 - name: page_size in: query description: 'The number of objects to return in the response.
Default: 50
Maximum: 100' schema: type: string example: 75 - name: page_num in: query description: 'The page to return starting from 0. Default: 0' schema: type: string example: 0 responses: '200': description: res - contains the specific error code:
9415 - Operation not allowed
1002 - Account doesn't exist content: application/json: schema: type: array items: $ref: '#/components/schemas/SubAccountStatus' /api/prov/v1/accounts/configure: post: tags: - Account Management summary: Modify account configuration description: Use this operation to change the configuration of the account of the API client or one of its managed accounts. operationId: modifyAccountConfiguration parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 - name: param in: query description: 'Name of the configuration parameter to set.
Possible values: name | email | plan_id | error_page_template | support_all_tls_versions | naked_domain_san_for_new_www_sites | wildcard_san_for_new_sites | ref_id
Note: plan_id, email, and error_page_template parameters are available for Reseller account only.' required: true schema: type: string example: email - name: value in: query description: 'According to the configuration paramater used.
For name - the updated name, for e-mail - the updated e-mail address.
For plan_id - a plan id.
For error_page_template - a Base64 encoded template for an error page.
For log_level - Available only for customers that purchased the Logs Integration SKU. Sets the log reporting level for the site. Possible values: full, security, none, default
For support_all_tls_versions - Use this operation to allow sites in the account to support all TLS versions for connectivity between clients (visitors) and the Imperva service. When this option is set, you can then enable the option per site to support all TLS versions. Possible values: true, false. Note: To remain PCI-compliant, do not enable this option.
For naked_domain_san_for_new_www_sites - Use this option to determine if the naked domain SAN will be added to the SSL certificate for new www sites. Default value: true
For wildcard_san_for_new_sites - Use this option to determine if the wildcard SAN or the full domain SAN is added to the Imperva SSL certificate for new sites. Possible values: true, false, default (determined by plan) Default value: default
For ref_id - Sets the Reference ID, a free-text field that enables you to add a unique identifier to correlate an object in our service, such as a protected website, with an object on the customer side.' required: true schema: type: string example: John@example.com responses: '200': description: res - contains the specific error code:
6001 - Invalid configuration parameter name
6002 - Invalid configuration parameter value
6003 - Action required
2 - Invalid input
9415 - Operation not allowed
1 - Unexpected error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/delete: post: tags: - Account Management summary: Delete managed account description: 'Available for Reseller accounts only Use this operation to delete an account.' operationId: deleteAccount parameters: - name: account_id in: query description: Numeric identifier of the account to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
1 - Unexpected error
2 - Invalid input
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/subaccounts/delete: post: tags: - Account Management summary: Delete sub account description: Use this operation to delete a sub account. operationId: deleteSubAccount parameters: - name: sub_account_id in: query description: Numeric identifier of the sub account to operate on. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
1 - Unexpected error
2002 - Invalid input2001 - Object is not empty
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts: post: tags: - Account Management summary: Get account status description: Use this operation to get account status operationId: getAccountStatus parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApiResultAccountStatus' /api/prov/v1/accounts/setlog: post: tags: - Account Management summary: Modify account log level description: Available for Reseller accounts only
Use this operation to change the account log configuration. operationId: modifyAccountLogLevel parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 - name: log_level in: query description: 'Sets the log reporting level for the site.
Possible values: full, security, none, default
Available only for customers that purchased the Log Integration SKU.' required: true schema: type: string example: full responses: '200': description: res - contains the specific error code:
6001 - Invalid configuration parameter name
1003 - Plan ID invalid
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/subscription: post: tags: - Account Management summary: Get account subscription details description: Use this operation to get subscription details for an account. operationId: subscription parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: integer format: int64 example: 10 responses: '200': description: Success content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultAccountSubscription' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/add: post: tags: - Account Management summary: Add a new managed account description: 'Available for Reseller accounts only
Use this operation to add a new account that should be managed by the account of the API client (the parent account). The new account will be configured according to the preferences set for the parent account by Imperva. Depending on these preferences, an activation e-mail will be sent to the specified e-mail address. The user responds to the activation e-mail, selects a password, and can then log directly into the Imperva console. The same e-mail address can also be used to send system notifications to the account. The new account is identified by a numeric value as provided by Imperva in the response in the field account_id.' operationId: addAccount parameters: - name: email in: query description: 'Email address. For example: "joe@example.com".' required: true schema: type: string example: example@imperva.com - name: parent_id in: query description: The newly created account's parent id. If not specified, the invoking account will be assigned as the parent. schema: type: integer format: int64 example: 10 - name: name in: query description: 'The account owner''s name. For example: "John Doe".' schema: type: string example: Jhon - name: plan_id in: query description: An identifier of the plan to assign to the new account. For example, ent100 for the Enterprise 100 plan. schema: type: string example: ent100 - name: ref_id in: query description: Customer specific identifier for this operation. schema: type: string example: 324 - name: account_name in: query description: Account name. schema: type: string example: John Account - name: account_description in: query description: The account description schema: type: string example: Demo account - name: user_name in: query description: 'The account owner''s name. For example: "John Doe".' schema: type: string example: Jhon - name: log_level in: query description: 'Sets the log reporting level for the site.Possible values: full, security, none, default
Available only for customers that purchased the Logs Integration SKU.' schema: type: string example: full - name: logs_account_id in: query description: 'Numeric identifier of the account that purchased the logs integration SKU and which collects the logs.
If not specified, operation will be performed on the account identified by the authentication parameters. Available only for customers that purchased the Logs Integration SKU.' schema: type: string example: 15 responses: '200': description: res - contains the specific error code:
1003 - Plan ID invalid
1001 - Email invalid
1010 - Account exists
9403 - Unknown/unauthorized account_id content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultAccountStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/caching-rules/add: post: tags: - Site Management summary: Add a cache rule description: Use this operation for adding a cache rule operationId: addCacheRule parameters: - name: action in: query description: Rule action. See Possible action parameter values.
Possible action parameter values:
required: true schema: type: string example: HTTP_CACHE_CREATE_TAG - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: name in: query description: Rule name. required: true schema: type: string example: rule1 - name: filter in: query description: Rule will trigger only a request that matches this filter. For more details on filters, see Syntax Guide. schema: type: string example: URL == /admin - name: ttl in: query description: Rule TTL. Only relevant when action is HTTP_CACHE_MAKE_STATIC or HTTP_CACHE_CLIENT_CACHE_CTL schema: type: string example: TTL value - name: ttl_unit in: query description: Rule TTL time unit.
Must be one of SECONDS, MINUTES, HOURS, DAYS or WEEKS. If no time unit is provided, SECONDS is used.
Only relevant when action is HTTP_CACHE_MAKE_STATIC or HTTP_CACHE_CLIENT_CACHE_CTL schema: type: string example: SECONDS - name: differentiated_by_value in: query description: Value to differentiate by. HTTP_CACHE_DIFFERENTIATE_BY_HEADER - header name, HTTP_CACHE_DIFFERENTIATE_BY_COOKIE - cookie name, HTTP_CACHE_DIFFERENTIATE_BY_GEO - geo location
(ISO 3166-1 alpha-2 country codes ), otherwise irrelevant. schema: type: string example: cookie name - name: params in: query description: Comma separated list of parameters to ignore. schema: type: string example: '{a,b,c}' - name: all_params in: query description: 'When set to true: all parameters in cache key will be ignored.
Default: false.
Relevant for HTTP_CACHE_IGNORE_PARAMS action' schema: type: boolean example: true - name: tag_name in: query description: The name of the tag to add. schema: type: string example: tag example - name: text in: query description: Add text to the cache key as suffix. Relevant for the HTTP_CACHE_ENRICH_CACHE_KEY action schema: type: string example: suffix responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
2 - Invalid input content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultAddCacheRule' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/caching-rules/delete: post: tags: - Site Management summary: Delete a cache rule description: Use this operation for deleting a cache rule operationId: deleteCacheRule parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: rule_id in: query description: ID of the rule to change. required: true schema: type: integer format: int64 example: 3746 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
2 - Invalid input
2002 - Object is not found
1 - Unexpected error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/caching-rules/enable: post: tags: - Site Management summary: Enable or disable cache rule description: Use this operation for enabling or disable cache rule operationId: enableDisableCacheRule parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: rule_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 3746 - name: enable in: query description: When true, the rule will be enabled. Set to false to disable. required: true schema: type: string example: true responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
2 - Invalid input
2002 - Object is not found content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/caching-rules/list: post: tags: - Site Management summary: List cache rules for a given site description: Use this operation for representing cache rules for a given site operationId: listCacheRules parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: page_size in: query description: 'The number of objects to return in the response.
Default is 50.
Maximum: 100' schema: type: string example: 75 - name: page_num in: query description: The page to return starting from 0. Default is 0. schema: type: string example: 0 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
2 - Invalid input
content: application/json: schema: oneOf: - $ref: '#/components/schemas/SiteCacheRuleResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/caching-rules/edit: post: tags: - Site Management summary: Edit a cache rule description: Use this operation for editing a cache rule operationId: editCacheRule parameters: - name: action in: query description: Rule action. See Possible action parameter values.
Possible action parameter values:
required: true schema: type: string example: HTTP_CACHE_CREATE_TAG - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: rule_id in: query description: ID of the rule to change. required: true schema: type: integer format: int64 example: 3746 - name: name in: query description: Rule name. required: true schema: type: string example: rule1 - name: filter in: query description: Rule will trigger only a request that matches this filter. For more details on filters, see Syntax Guide. schema: type: string example: URL == /admin - name: ttl in: query description: Rule TTL. Only relevant when action is HTTP_CACHE_MAKE_STATIC or HTTP_CACHE_CLIENT_CACHE_CTL schema: type: string example: TTL value - name: ttl_unit in: query description: Rule TTL time unit.
Must be one of SECONDS, MINUTES, HOURS, DAYS or WEEKS. If no time unit is provided, SECONDS is used.
Only relevant when action is HTTP_CACHE_MAKE_STATIC or HTTP_CACHE_CLIENT_CACHE_CTL schema: type: string example: SECONDS - name: differentiated_by_value in: query description: Value to differentiate by. HTTP_CACHE_DIFFERENTIATE_BY_HEADER - header name, HTTP_CACHE_DIFFERENTIATE_BY_COOKIE - cookie name, HTTP_CACHE_DIFFERENTIATE_BY_GEO - geo location
(ISO 3166-1 alpha-2 country codes ), otherwise irrelevant. schema: type: string example: cookie name - name: params in: query description: Comma separated list of parameters to ignore. schema: type: string example: '{a,b,c}' - name: all_params in: query description: 'When set to true: all parameters in cache key will be ignored.
Default: false.
Relevant for HTTP_CACHE_IGNORE_PARAMS action' schema: type: boolean example: true - name: tag_name in: query description: The name of the tag to add. schema: type: string example: tag1 - name: text in: query description: Add text to the cache key as suffix. Relevant for the HTTP_CACHE_ENRICH_CACHE_KEY action schema: type: string example: cache responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
2 - Invalid input
2002 - Object is not found content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/v1/infra/stats: post: tags: - Traffic Statistics and Logs summary: Get Infrastructure Protection Statistics description: Use this operation to get Infrastructure Protection event information for an account. operationId: getInfraStats parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: integer format: int64 example: 10 - name: ip_prefix in: query description: Specific Protected IP or IP range. For example, 1.1.1.0/24. schema: type: string example: 1.1.1.0/24 - name: traffic in: query description: 'Specific traffic. One of: Total, Passed, Blocked.' schema: type: string example: Blocked - name: traffic_type in: query description: 'A comma separated list of specific traffic types. Any of: UDP, TCP, DNS, DNS_RESPONSE, ICMP, SYN, FRAG, LARGE_SYN, NTP, NETFLOW, SSDP, GENERAL. Cannot be used together with the pop parameter.' schema: type: string example: TCP - name: pop in: query description: 'A comma separated list of specific PoP names. For example: iad, tko. Cannot be used together with the traffic_type parameter. For the list of PoP codes and locations, see Imperva Data Centers (PoPs).' schema: type: string example: tko - name: start in: query description: 'The start date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: integer format: int64 example: 1610356734 - name: end in: query description: 'The end date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: integer format: int64 example: 1610356734 - name: directionTypes in: query description: The type of direction(INGRESS/EGRESS) to filter the data schema: type: string example: INGRESS - name: range_type in: query description: 'Can be one of the following: BGP, PROTECTED_IP' schema: type: string example: INCAPSULA_IP responses: '200': description: res - contains the specific error code:
2 - Invalid input
3015 - Internal error content: application/json: schema: oneOf: - $ref: '#/components/schemas/InfraStatsApiResponse' - $ref: '#/components/schemas/ApiResult' /api/stats/v1: post: tags: - Traffic Statistics and Logs summary: Get statistics description: Get site statistics for one or more sites. This operation may return multiple statistics, as specified in the stats parameter. operationId: getStats parameters: - name: account_id in: query description: 'Numeric identifier of the account to fetch data for.
Note: You must specify either account_id or site_id.' schema: type: string example: 10 - name: time_range in: query description: 'Time range to fetch data for.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' required: true schema: type: string example: last_7_days - name: start in: query description: 'Start date in milliseconds since 1970. Used together with the time_range parameter to specify a custom time range.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: string example: 1610356734 - name: end in: query description: 'End date in milliseconds since 1970. Used together with the time_range parameter to specify a custom time range.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: string example: 1610356734 - name: site_id in: query description: 'Numeric identifier of the site to fetch data for. Multiple sites can be specified in a comma separated list. For example: 123,124,125.
Note: You must specify either account_id or site_id.' schema: type: string example: 123 - name: stats in: query description: Statistics to fetch, as specified in the table below. Multiple statistics can be specified in a comma separated list.
Values for the stats parameters:
required: true schema: type: string example: threats - name: granularity in: query description: 'Time interval in milliseconds between data points for time series statistics. (See the timeseries values in the table below.)
The default granularity depends on the specified time range, as follows:
The response includes one result for each interval. For example, if you specify a time range value of last_7_days, the default granularity is 1 day, and the response will return 7 results.' schema: type: string example: 7200000 responses: '200': description: res - contains the specific error code:
13001 (Timerange invalid), 13002 (Granularity invalid) content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStats' - $ref: '#/components/schemas/ApiResult' /api/v1/infra/top-table: post: tags: - Traffic Statistics and Logs summary: Get Infrastructure Protection Top Items (Table View) description: Use this operation to view the highest peak values and highest average values for a protected IP range during a selected time period. operationId: getInfraProtectTopTable parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: integer format: int64 example: 10 - name: ip_range in: query description: The customer's IP range. required: true schema: type: string example: INCAPSULA_IP - name: range_type in: query description: 'One of the following: BGP, PROTECTED_IP' required: true schema: type: string example: PROTECTED_IP - name: start in: query description: 'The start date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' required: true schema: type: integer format: int64 example: 1610356734 - name: end in: query description: 'The end date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' required: true schema: type: integer format: int64 example: 1610356734 - name: data_type in: query description: 'One of the following: SRC_IP, DST_IP, SRC_PORT_PROTOCOL, DST_PORT_PROTOCOL' required: true schema: type: string example: SRC_IP - name: metric_type in: query description: 'One of the following: SRC_IP, DST_IP, SRC_PORT_PROTOCOL, DST_PORT_PROTOCOL' required: true schema: type: string example: BPS - name: mitigation_type in: query description: 'One of the following: BLOCK, PASS' required: true schema: type: string example: BLOCK - name: aggregation_type in: query description: 'One of the following: PEAK, AVERAGE' required: true schema: type: string example: AVERAGE - name: data_storage_region in: query description: The data region to use. If not specified, account's default data region will be used. schema: type: string example: EU responses: '200': description: res - contains the specific error code:
2 - Invalid input
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/AnalyticsTopTableApiResponse' - $ref: '#/components/schemas/ApiResult' /api/v1/infra/top-graph: post: tags: - Traffic Statistics and Logs summary: Get Infrastructure Protection Top Items (Graph View) description: Use this operation to view the highest peak values and highest average values for a protected IP range during a selected time period. operationId: getInfraProtectTopData parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: integer format: int64 example: 10 - name: ip_range in: query description: The customer's IP range. required: true schema: type: string example: INCAPSULA_IP - name: range_type in: query description: 'One of the following: BGP, PROTECTED_IP' required: true schema: type: string example: PROTECTED_IP - name: start in: query description: 'The start date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' required: true schema: type: integer format: int64 example: 1610356734 - name: end in: query description: 'The end date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' required: true schema: type: integer format: int64 example: 1610356734 - name: data_type in: query description: 'One of the following: SRC_IP, DST_IP, SRC_PORT_PROTOCOL, DST_PORT_PROTOCOL' required: true schema: type: string example: SRC_IP - name: metric_type in: query description: 'One of the following: BW, PPS' required: true schema: type: string example: BPS - name: mitigation_type in: query description: 'One of the following: BLOCK, PASS' required: true schema: type: string example: BLOCK - name: data_storage_region in: query description: The data region to use. If not specified, account's default data region will be used. schema: type: string example: EU - name: objects in: query description: A comma separated list of items to fetch data for. e.g., 10.10.10.10, 2.2.2.2. If not specified, top items are automatically fetched. schema: type: string example: 1.1.1.1 responses: '200': description: res - contains the specific error code:
2 - Invalid input
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/AnalyticsTopGraphDataResponse' - $ref: '#/components/schemas/ApiResult' /api/v1/infra/histogram: post: tags: - Traffic Statistics and Logs summary: Get Infrastructure Protection Histogram description: Use this operation to view the highest packet size values for a protected IP range during a selected time period. operationId: getInfraProtectHistogram parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: integer format: int64 example: 10 - name: ip_range in: query description: The customer's IP range. required: true schema: type: string example: INCAPSULA_IP - name: range_type in: query description: 'One of the following: BGP, PROTECTED_IP' required: true schema: type: string example: PROTECTED_IP - name: start in: query description: 'The start date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' required: true schema: type: integer format: int64 example: 1610356734 - name: end in: query description: 'The end date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' required: true schema: type: integer format: int64 example: 1610356734 - name: mitigation_type in: query description: 'One of the following: BLOCK, PASS' required: true schema: type: string example: BLOCK - name: data_storage_region in: query description: The data region to use. If not specified, account's default data region will be used. schema: type: string example: EU responses: '200': description: res - contains the specific error code:
2 - Invalid input
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/AnalyticsHistogramApiResponse' - $ref: '#/components/schemas/ApiResult' /api/visits/v1: post: tags: - Traffic Statistics and Logs summary: Get visits description: Use this operation to get a log of recent visits to a website. operationId: getVisits parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: time_range in: query description: 'Time range to fetch data for. Default is last_7_days.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: string example: last_7_days - name: start in: query description: 'Start date in milliseconds since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: string example: 1610356734 - name: end in: query description: 'End date in milliseconds since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: string example: 1610356734 - name: page_size in: query description: The number of objects to return in the response. Defaults to 10. Maximum is 100. schema: type: string example: 15 - name: page_num in: query description: The page to return starting from 0. Default to 0. schema: type: string example: 1 - name: security in: query description: 'Filter the sessions that were handled according to the security-related specifications. Multiple values are supported, e.g.: "api.threats.action.block_ip, api.threats.sql_injection".' schema: type: string example: api.threats.action.block_ip - name: country in: query description: Filter the sessions coming from the specified country. schema: type: string example: SE - name: ip in: query description: Filter the sessions coming from the specified IP. schema: type: string example: 1.2.3.4 - name: visit_id in: query description: Comma separated list of visit IDs to load. schema: type: string example: 133077760038625792 - name: list_live_visits in: query description: 'Whether or not to list visits that did not end and that may still be updated.
Possible values: true, false
Default: true' schema: type: string example: true - name: use_previous_region in: query description: 'Whether or not to list visits from old region data. Valid only if a data region was changed in the last 90 days. One of: true | false. Default: false' schema: type: string example: true responses: '200': description: res - contains the specific error code:
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSessions' - $ref: '#/components/schemas/ApiResult' /api/logscollector/upload/publickey: post: tags: - Traffic Statistics and Logs summary: Upload Public Key description: Available only for Enterprise Plan customers that purchased the Security Logs Integration SKU. operationId: uploadLCPublicKey parameters: - name: config_id in: query description: The Logs Collector configuration identifier. required: true schema: type: string example: 5912 - name: public_key in: query description: The public key file (2048bit) in base64 format (without password protection). required: true schema: type: string example: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAp dkVeG9ypRTuOUq4jocTQBXupcT wqH/gmCxb5xqdp0Dxrac91VsPmmGTNw0vMrcZfXPzRM26zzkhakA9vKR9TobpML3Tv90Gb43XByHjwipYNBxN/nfjCksXigqfqLUtiUODPfSqdwoUk6PJHAUnCvp8boPGaLFiFvwlPwtjBp8lNb4jgMH3Czbbgk3Q p zXIEg024WAGnp NrjsNM1xAuP9ON T096iBJaJqX7H2heWGw/7UqR eMtv7/vGilhi9kX2/sgNe5LDdAqdcWjzeCDXVqzqk rxil kHnAkwJ7eNAi49i4f6Zl6Zyhpf69fI0KOjaCI7QrEXZ1jwLQIDAQAB responses: '200': description: res - contains the specific error code:
2 - Invalid input
13008 - Invalid configuration ID
13009 - Invalid key length
13007 - Invalid public key content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultLCPublicKey' - $ref: '#/components/schemas/ApiResult' /api/logscollector/change/status: post: tags: - Traffic Statistics and Logs summary: Change Logs Collector Configuration Status description: Change the status of the Logs Collector configuration. operationId: changeLogsCollectorsConfigStatus parameters: - name: config_id in: query description: The Logs Collector configuration identifier. required: true schema: type: string example: 5912 - name: logs_config_new_status in: query description: 'The new configuration status of the Logs Collector. Possible values: ACTIVE, SUSPENDED' required: true schema: type: string example: ACTIVE responses: '200': description: res - contains the specific error code:
2 - Invalid input
13008 - Invalid configuration ID content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/v1/infra/events: post: tags: - Traffic Statistics and Logs summary: Get Infrastructure Protection Events description: Use this operation to get Infrastructure Protection event information for an account operationId: getInfraEvents parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 - name: event_type in: query description: 'A comma separated list of specific event types. Any of: GRE_TUNNEL_UP, GRE_TUNNEL_DOWN, ORIGIN_CONNECTION_GRE_UP, ORIGIN_CONNECTION_GRE_DOWN, ORIGIN_CONNECTION_ECX_UP, ORIGIN_CONNECTION_ECX_DOWN, ORIGIN_CONNECTION_CROSS_CONNECT_UP, ORIGIN_CONNECTION_CROSS_CONNECT_DOWN, DDOS_START_IP_RANGE, DDOS_STOP_IP_RANGE, DDOS_QUIET_TIME_IP_RANGE, EXPORTER_NO_DATA, EXPORTER_BAD_DATA, EXPORTER_GOOD_DATA, MONITORING_CRITICAL_ATTACK, PROTECTED_IP_STATUS_UP, PROTECTED_IP_STATUS_DOWN, PER_IP_DDOS_START_IP_RANGE.' schema: type: string example: GRE_TUNNEL_UP - name: ip_prefix in: query description: Specific Protected IP or IP range. For example, 1.1.1.0/24. schema: type: string example: 1.1.1.0/24 - name: page_size in: query description: 'The number of objects to return in the response.
Default: 50
Maximum: 100' schema: type: string example: 2 - name: page_num in: query description: 'The page to return starting from 0. Default: 0' schema: type: string example: 1 - name: start in: query description: 'The start date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: string example: 1610356734 - name: end in: query description: 'The end date in milliseconds, since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
' schema: type: string example: 1610356734 responses: '200': description: res - contains the specific error code:
2 - Invalid input content: application/json: schema: oneOf: - $ref: '#/components/schemas/InfraEventsApiResponse' - $ref: '#/components/schemas/ApiResult' /api/integration/v1/ips: post: tags: - Integrations summary: Get Imperva IP Ranges description: Use this operation to get the updated list of Imperva IP ranges. This list may be used to define firewall rules that restrict access to customers sites from non-Imperva IPs. operationId: getIPRanges parameters: - name: resp_format in: query description: 'Response format.
Possible values: json | apache | nginx | iptables | text
Default: json' schema: type: string example: json responses: '200': description: res - contains the specific error code:
14001 - Format invalid content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultIncapsulaRanges' - $ref: '#/components/schemas/ApiResult' /api/integration/v1/texts: post: tags: - Integrations summary: Get Texts description: Use this operation to retrieve a list of all text messages that may be part of API responses. For each message a key and a value are provided. The key is the unique identifier of the message and the value is the message text itself, in the API's default locale (English). operationId: getTexts responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApiResultGetTexts' /api/integration/v1/geo: post: tags: - Integrations summary: Get Geographical Info description: Use this operation to retrieve a list of all the countries and continents codes. operationId: getGeoInfo responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GeoInfo' /api/integration/v1/clapps: post: tags: - Integrations summary: Get Client Applications Info description: Use this operation to retrieve a list of all the client applications. operationId: getClappsInfo responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApiResultGetClappsInfo' /api/prov/v1/sites/lp/configure: post: tags: - Login Protect summary: Add Login Protect User description: Use this operation to change Login Protect settings for a site. operationId: modifyLpSiteConfiguration parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: enabled in: query description: 'Pass true to enable login protect on site, and false to disable it.
Default: true' schema: type: boolean example: true - name: specific_users_list in: query description: Comma separated email list to set login protect users for the site. If the list is empty all users will be allowed to access the site using Login Protect. schema: type: string example: admin@example.com - name: send_lp_notifications in: query description: 'Pass true to send notification on successful login using login protect.
Default: false' schema: type: boolean example: true - name: allow_all_users in: query description: 'Pass true to allow all login protect users to access the site. If you want to allow only a specific list of users to access the site using Login Protect set this to false, and add the list to specific_user_list.
Default: true' schema: type: boolean example: true - name: authentication_methods in: query description: 'Comma separated list of allowed authentication methods: sms | email | ga' schema: type: string example: sms - name: urls in: query description: A comma separated list of resource paths. For example, /home and /admin/index.html are resource paths, while http://www.example.com/home is not. Each URL should be encoded separately using percent encoding as specified by RFC 3986 (http://tools.ietf.org/html/rfc3986#section-2.1). An empty URL list will remove all URLs. schema: type: string example: /home - name: url_patterns in: query description: 'A comma separated list of url patterns. Possible values: contains | equals | prefix | suffix | not_equals | not_contain | not_prefix | not_suffix. The patterns should be in accordance with the matching urls sent by the urls parameter.' schema: type: string example: prefix responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
18001 - Format invalid
18002 - Application invalid
18011 - Invalid SMS Text
9403 - Unknown/unauthorized account_id
1001 - E-mail invalid
18003 - Invalid phone number content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/lp/configure-app: post: tags: - Login Protect summary: Configure Login Protect on Admin Areas description: Use this operation to configure Login Protect on wordpress | joomla | phpbb admin areas. operationId: configureProtectedAppByLp parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: protected_app in: query description: Protect admin areas of joomla | wordpress | phpBB. schema: type: string example: wordpress responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
18001 - Format invalid
18002 - Application invalid
18011 - Invalid SMS Text
9403 - Unknown/unauthorized account_id
1001 - E-mail invalid
18003 - Invalid phone number content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/lp/add-user: post: tags: - Login Protect summary: Add Login Protect User description: Use this operation to add a Login Protect user for a site. operationId: addLpUser parameters: - name: account_id in: query description: Numeric identifier of the account to operate on. required: true schema: type: string example: 10 - name: email in: query description: Email address. required: true schema: type: string example: admin@example.com - name: name in: query description: 'Example: John Smith' schema: type: string example: John Smith - name: phone in: query description: 'Phone number. For example: "1-8662507659"' schema: type: string example: 1-8662507659 - name: is_phone_verified in: query description: Whether or not to skip phone verification. schema: type: boolean example: true - name: is_email_verified in: query description: Whether or not to skip email address verification. schema: type: boolean example: true - name: should_send_activation_email in: query description: Whether or not to send activation email to user. schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account_id
1001 - E-mail invalid
18005 - Login Protect User Exists
18006 - Operation Not Allowed
18009 - Not Supported Action
18004 - Failed to Send E-Mail content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/lp/users: post: tags: - Login Protect summary: Get Login Protect Users description: Use this operation to get the account's login protect user list. operationId: getLpUsers parameters: - name: account_id in: query description: Numeric identifier of the account to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
18003 - Invalid phone number
18004 - Failed to Send E-Mail
9403 - Unknown/unauthorized account_id
1001 - E-mail invalid
18005 - Login Protect User Exists
18006 - Operation Not Allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/LoginProtectUsersApiResults' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/lp/edit-user: post: tags: - Login Protect summary: Edit Login Protect User description: Edit Login Protect user's settings. operationId: editLpUser parameters: - name: account_id in: query description: Numeric identifier of the account to operate on. required: true schema: type: string example: 10 - name: email in: query description: Email address. required: true schema: type: string example: admin@example.com - name: name in: query description: 'Example: John Smith' schema: type: string example: John Smith - name: phone in: query description: 'Phone number. For example: "1-8662507659"' schema: type: string example: 1-8662507659 - name: is_phone_verified in: query description: Whether or not to skip phone verification. schema: type: boolean example: true - name: is_email_verified in: query description: Whether or not to skip email address verification. schema: type: boolean example: true - name: should_send_activation_email in: query description: Whether or not to send activation email to user. schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account_id
1001 - E-mail invalid
18005 - Login Protect User Exists
18006 - Operation Not Allowed
18009 - Not Supported Action
18004 - Failed to Send E-Mail content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/lp/send-sms: post: tags: - Login Protect summary: Send SMS to User description: Use this operation to send an SMS to a login protect user. operationId: sendSms parameters: - name: account_id in: query description: Numeric identifier of the account to operate on. required: true schema: type: string example: 10 - name: email in: query description: Email address. required: true schema: type: string example: admin@example.com - name: sms_text in: query description: Text that will be sent in SMS. required: true schema: type: string example: hello responses: '200': description: res - contains the specific error code:
18003 -Invalid phone number
18011 - Invalid SMS Text
9403 - Unknown/unauthorized account_id
18010 - Invalid User
18007 - Exceeded Allowed SMS
18008 - Failed to Send SMS content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/lp/remove: post: tags: - Login Protect summary: Remove Login Protect User description: Use this operation to remove a login protect user from an account's user list. operationId: removeLpUser parameters: - name: account_id in: query description: Numeric identifier of the account to operate on. required: true schema: type: string example: 10 - name: email in: query description: Email address. required: true schema: type: string example: admin@example.com responses: '200': description: res - contains the specific error code:
18003 - Invalid phone number
18004 - Failed to Send E-Mail
9403 - Unknown/unauthorized account_id
1001 - E-mail invalid
18005 - Login Protect User Exists
18006 - Operation Not Allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/add: post: tags: - Site Management summary: Add data center description: Use this operation for adding data center to site. operationId: addDataCenter parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: name in: query description: The new data center's name. required: true schema: type: string example: DataCenter - name: server_address in: query description: 'The server''s address. Possible values: IP, CNAME' required: true schema: type: string example: 1.1.1.1 - name: lb_algorithm in: query description: Data center load balancing algorithm. Possible values are:
LB_LEAST_PENDING_REQUESTS - Server with least pending requests
LB_LEAST_OPEN_CONNECTIONS - Server with least open connections
LB_SOURCE_IP_HASH - Server by IP hash
RANDOM - Random server
WEIGHTED - Server by weight schema: type: string enum: - LB_LEAST_PENDING_REQUESTS - LB_LEAST_OPEN_CONNECTIONS - LB_SOURCE_IP_HASH - RANDOM - WEIGHTED example: LB_LEAST_PENDING_REQUESTS - name: is_enabled in: query description: Enables the data center. schema: type: boolean example: true - name: is_content in: query description: The data center will be available for specific resources (Forward Delivery Rules). schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
2 - a datacenter with that name already exists content: application/json: schema: oneOf: - $ref: '#/components/schemas/DataCenterResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/edit: post: tags: - Site Management summary: Edit site description: Use this operation to editing site's data center operationId: editDataCenter parameters: - name: dc_id in: query description: The data center's ID. required: true schema: type: integer format: int64 example: 10 - name: name in: query description: The new data center's name. schema: type: string example: DataCenter - name: is_enabled in: query description: Enables the data center. schema: type: boolean example: true - name: is_standby in: query description: Defines the data center as standby for failover. schema: type: boolean example: true - name: is_content in: query description: The data center will be available for specific resources (Forward Delivery Rules). schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
9413 -invalid datacenter
2- datacenter with that name already exists content: application/json: schema: oneOf: - $ref: '#/components/schemas/DataCenterResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/resume: post: tags: - Site Management summary: Resume traffic to your active data centers description: When at least one active data center is back up, you have to manually reroute your traffic back to the active data center.
Traffic does not revert automatically to your active data centers. operationId: resumeTrafficToActiveDCs parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
9413 -Unknown/unauthorized site_id content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/delete: post: tags: - Site Management summary: delete site description: Use this operation for deleting site datacenter. operationId: deleteDataCenter parameters: - name: dc_id in: query description: The data center's ID. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
5 -Could not delete datacenter
2- invalid datacenter
9415- invalid.dc.state
3011 - There must be at least one active data center not configured for forward rules in the site content: application/json: schema: oneOf: - $ref: '#/components/schemas/DataCenterResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/servers/add: post: tags: - Site Management summary: 'Add datacenter ' description: Use this operation to adding datacenter server. operationId: addDCServer parameters: - name: dc_id in: query description: The data center's ID. required: true schema: type: integer format: int64 example: 10 - name: server_address in: query description: Server IP address. required: true schema: type: string example: 1.1.1.1 - name: is_disabled in: query description: Enables the data center schema: type: boolean example: true - name: is_standby in: query description: Set the server as Active (P0) or Standby (P1) (Boolean). schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
1 -General error
2- invalid datacenter content: application/json: schema: oneOf: - $ref: '#/components/schemas/ServerOperationResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/servers/delete: post: tags: - Site Management summary: 'Delete datacenter ' description: Use this operation to deleting datacenter server. operationId: deleteDCServer parameters: - name: server_id in: query description: Server ID. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
9415 -invalid.server.state
2- invalid datacenter
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ServerOperationResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/servers/edit: post: tags: - Site Management summary: Edit datacenter description: Use this operation to editing datacenter server. operationId: editDCServer parameters: - name: server_id in: query description: Server ID. required: true schema: type: integer format: int64 example: 10 - name: server_address in: query description: The IP address of the server to modify. schema: type: string example: 1.1.1.1 - name: is_enabled in: query description: Enable or disable the server (Boolean). schema: type: boolean example: true - name: is_standby in: query description: Set the server as Active (P0) or Standby (P1) (Boolean). schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
9415 -invalid.server.state
2- invalid datacenter
1 -Unexpected error
9413 -invalid server
1 -General error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ServerOperationResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/dataCenters/list: post: tags: - Site Management summary: List site's data centers description: Use this operation for listing site's data centers including datacenters servers. operationId: listDataCenters parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
9413 - invalid site
2 - invalid datacenter
content: application/json: schema: oneOf: - $ref: '#/components/schemas/ListDataCenterResponse' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/datacenter/origin-pop/modify: post: tags: - Site Management summary: Set Data Center Origin PoP description: Set an origin PoP for a given data center. operationId: setDataCenterOriginPoP parameters: - name: dc_id in: query description: Numeric identifier of the data center to operate on. required: true schema: type: integer format: int64 example: 10 - name: origin_pop in: query description: 'The ID of the PoP that serves as an access point between Imperva and the customer’s origin server. For example: “lax”, for Los Angeles.' schema: type: string example: lax, for Los Angeles responses: '200': description: res - contains the specific error code:
405 - Api is disabled
2 - invalid datacenter
5 - Cant set Origin PoP for datacenter content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/datacenter/origin-pop/recommend: post: tags: - Site Management summary: Get Data Center Recommended Origin PoPs description: Get a list of recommended origin PoPs for a given data center. operationId: getRecommendedDataCenterOriginPoPs parameters: - name: dc_id in: query description: Numeric identifier of the data center to operate on. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
405 - Api is disabled
2- invalid datacenter
5 - Cant set Origin PoP for datacenter content: application/json: schema: oneOf: - $ref: '#/components/schemas/RecommendedPopsApiResult' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache-mode: post: tags: - Site Management summary: Modify Caching Mode description: Use this operation to edit basic site caching settings. operationId: setCachingMode parameters: - name: cache_mode in: query description: 'Possible values:
' required: true schema: type: string example: static_and_dynamic - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: dynamic_cache_duration in: query description: 'Profile dynamic pages and cache duration. Pass a number followed by ''_'' and one of: hr | min | sec | days | weeks.
Default: 5_min' schema: type: string example: 5_min - name: aggressive_cache_duration in: query description: 'Cache resource duration. Pass a number followed by ''_'' and one of: hr | min | sec | days | weeks
Default: 1_hr' schema: type: string example: 1_hr responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache-mode/get: post: tags: - Site Management summary: Get Caching Mode description: Use this operation to get a site's caching mode. operationId: getCachingMode parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetCacheMode' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/purge: post: tags: - Site Management summary: Purge Resources description: Use this operation to purge site resources. operationId: modifyPurgeSettings parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: resource_url in: query description: Comma separated list of URLs where the resource is located. required: true schema: type: string example: /home - name: resource_pattern in: query description: 'Comma separated list of pattern. One of: contains | equals | prefix | suffix | not_equals | not_contains | not_prefix | not_suffix' required: true schema: type: string example: prefix - name: should_purge_all_site_resources in: query description: 'Should purge all cached resources on site.
Possible values:
If the parameter does not exist, is null, or an empty string, it is ignored and only specific resources defined by the resource_pattern and resource_url parameters are purged.
true or TRUE: All site resources are purged.
false or FALSE: Nothing is done.
Any other string: An error is returned.' schema: type: string example: true responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
3015 - Internal error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/cache/purge: post: tags: - Site Management summary: Purge Site Cache description: Use this operation to purge all cached content on our proxy servers for a specific site.
Our Proxy servers keep cached content of your sites in order to accelerate page load times for your users.
When you want this cached content to be refreshed (for example, after making adjustments in your site) you can use this API call.
In order to purge the entire cached content for this site just use the API call with no parameters.
If you want to purge a specific resource add the resource name as parameter. operationId: purgeSiteCache parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: purge_pattern in: query description: The pattern of the resource to be purged from the cache. For example:
schema: type: string - name: purge_tag_names in: query description: A comma separated list of tag names to purge. schema: type: string responses: '200': description: res - contains the specific error code:
5010 - Pattern invalid
9413 - Unknown/unauthorized site_id.
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/response-headers: post: tags: - Site Management summary: Modify Cached Response Headers description: Use this operation to modify cached response headers. operationId: modifyResponseHeaderSettings parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: cache_headers in: query description: Comma separated list of header names to be cached schema: type: string example: h1 - name: cache_all_headers in: query description: Cache all response headers. Pass "true" or "false" in the value parameter. Cannot be selected together with cache_headers. Default:false schema: type: string example: true responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/response-headers/get: post: tags: - Site Management summary: Get Cached Response Headers description: Use this operation to get a site's cached response headers. operationId: getResponseHeaderSettings parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
5 - Operation is unavailable content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetResponseHeaderSettings' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/tag-response: post: tags: - Site Management summary: Tag the Response According to the Value of a Header description: Specify which origin response header contains the cache tags in your resources. operationId: modifyTagResponseHeader parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: header in: query description: 'Specify which origin response header contains the cache tags in your resources. default: "".' required: true schema: type: string example: cache responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/tag-response/get: post: tags: - Site Management summary: Get Header to Tag Responses By description: Get the origin response header containing the cache tags in your resources operationId: getTagResponseHeader parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetTagResponseHeader' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache404/modify: post: tags: - Site Management summary: Modify Cache 404 Settings description: Use this operation to modify the caching settings of 404 responses for a site. operationId: modifyCache404Settings parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: enable in: query description: Pass 'true' to cache 404 responses, 'false' to disable the option. required: true schema: type: string example: true - name: time in: query description: 'A positive number representing the amount of time to cache 404 responses. Default value: 10' schema: type: string example: 10 - name: time_unit in: query description: 'Unit of time for caching 404 responses. One of MINUTES, HOURS, DAYS, WEEKS. Default value: HOURS' schema: type: string example: HOURS responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache404: post: tags: - Site Management summary: Get Cache 404 Settings description: Use this operation to get the caching settings of 404 responses for a site. operationId: getCache404Settings parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/GetCache404SettingsApiResult' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/pop-level-cache/modify: post: tags: - Site Management summary: Modify PoP Level Cache description: Use this operation to modify the PoP level cache status for a site. operationId: modifyPopLevelCache parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: enable in: query description: Pass 'true' to enable pop level cache, 'false' to disable the option. required: true schema: type: string example: true responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/pop-level-cache: post: tags: - Site Management summary: Get PoP Level Cache description: Use this operation to get the PoP level cache status for a site. operationId: getPopLevelCache parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id content: application/json: schema: oneOf: - $ref: '#/components/schemas/GetPopLevelCacheSettingsApiResult' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/resource-map-size/modify: post: tags: - Site Management summary: Set Resource Map Size description: Set the site's maximum number of cached resources. operationId: setResourceMapSize parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: resource_map_size in: query description: Limit for the amount of cached resources. required: true schema: type: string example: 34000 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/resource-map-size: post: tags: - Site Management summary: Get Resource Map Size description: Get the site's maximum number of cached resources. operationId: getResourceMapSize parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 responses: '200': description: res - res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetResourceMapSize' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache-size-limit-large-mem/modify: post: tags: - Site Management summary: Set Total Cache Size description: Set the site's limit for the total size of cache. operationId: setCacheSizeLimitLargeMem parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: cache_size_limit_large_mem in: query description: A positive number representing limit for total size of cached resources. required: true schema: type: string example: 500 - name: cache_size_limit_large_mem_unit in: query description: Unit of the limit for total size of cached resources. One of BYTES, KB, MB. required: true schema: type: string example: BYTES responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache-size-limit-large-mem: post: tags: - Site Management summary: Get Total Cache Size description: Get the site's limit for the total size of cache. operationId: getCacheSizeLimitLargeMem parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 responses: '200': description: res - res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetCacheSizeLimitLargeMem' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/max-resp-size/modify: post: tags: - Site Management summary: Set Response Max Size description: Set the site's limit for the size of a single file returned from the cache. operationId: setMaxRespSize parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: max_resp_size in: query description: A positive number representing limit for the size of cached resources. required: true schema: type: string example: 20971520 - name: max_resp_size_unit in: query description: Unit of the limit for the size of cached resources. One of BYTES, KB, MB. required: true schema: type: string example: BYTES responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/max-resp-size: post: tags: - Site Management summary: Get Response Max Size description: Get the site's limit for the size of a single file returned from the cache. operationId: getMaxRespSize parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetMaxRespSize' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/secure-resources: post: tags: - Site Management summary: Modify Secure Resources Mode description: Use this operation to modify the Secure Resources mode for a site. operationId: setSecureResourcesMode parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: secured_resources_mode in: query description: do_not_cache - Do not cache HTTPS resources
defaults - Use default HTTPS caching. Do not cache HTML pages
defaults_with_html - Use default HTTPS caching. Also cache HTML pages
general - Cache HTTPS according to general caching settings required: true schema: type: string responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/secure-resources/get: post: tags: - Site Management summary: Get Secure Resources Mode description: Use this operation to get the Secure Resources mode for a site. operationId: getSecureResourcesMode parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetSecureResources' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/stale-content: post: tags: - Site Management summary: Modify Stale Content Settings description: When Imperva can't connect to the origin server, serve stale content instead of displaying an error to end users for the specified amount of time. Expired resources are returned from cache, and refreshed asynchronously in the background. operationId: modifyStaleContent parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: serve_stale_content in: query description: Pass true to serve stale content, false to disable the option. required: true schema: type: string example: true - name: stale_content_mode in: query description: Pass ADAPTIVE to use Imperva's algorithm, or CUSTOM to specify an amount of time. When using CUSTOM, you must specify the time and time_unit parameters. schema: type: string example: ADAPTIVE - name: time in: query description: A positive number representing the amount of time to serve stale content. schema: type: string example: 10 - name: time_unit in: query description: Stale content time unit. One of SECONDS, MINUTES, HOURS. schema: type: string example: MINUTES responses: '200': description: 'res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
5 - Operation unavailable ' content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/stale-content/get: post: tags: - Site Management summary: Get Stale Content Settings description: When Imperva can't connect to the origin server, serve stale content instead of displaying an error to end users for the specified amount of time. Expired resources are returned from cache, and refreshed asynchronously in the background. operationId: getStaleContent parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/GetStaleContentApiResult' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/advanced: post: tags: - Site Management summary: Advanced Caching Settings description: Use this operation to modify advanced caching settings. operationId: modifyAdvancedCachingSettings parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: param in: query description: 'Name of configuration parameter to set.
Possible values for param and value parameters:
' required: true schema: type: string example: async_validation - name: value in: query description: According to the param value. required: true schema: type: string example: true responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
5 - Operation unavailable content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/advanced/get: post: tags: - Site Management summary: Get Advanced Caching Settings description: Use this operation to get advanced caching settings. operationId: getAdvancedCachingSettings parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: param in: query description: 'Name of configuration parameter to set.
Possible values for param and value parameters:
' required: true schema: type: string example: async_validation responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id content: application/json: schema: oneOf: - $ref: '#/components/schemas/GetAdvancedCachingSettingsApiResult' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/xray/get-link: post: tags: - Site Management summary: Get XRay Access Link description: 'Use this operation to get a URL that enables debug headers on the specific site. ' operationId: getXrayLink parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetSiteXrayLink' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache-shield/enable: post: tags: - Site Management summary: Enable Cache Shield description: Enable Cache Shield for a given site. operationId: enableCacheShield parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: enable in: query description: Use true to enable cache shield on the specified site, and false to disable it. required: true schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
1 - Unexpected error
405 - Api is disabled content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/cache-shield: post: tags: - Site Management summary: Is Cache Shield Enabled description: Get the enablement state of the Cache Shield feature for a given site. operationId: isCacheShieldEnabled parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/IsCacheShieldEnabledApiResult' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/rewrite-port/modify: post: tags: - Site Management summary: Modify Rewrite Port description: Use this operation to rewrite the port number used to access the origin server. operationId: modifyRewritePorts parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: rewrite_port_enabled in: query description: Boolean value to indicate whether the default non-SSL port should be rewritten or not required: true schema: type: boolean example: true - name: port in: query description: The port number. If empty, rewrite port will be removed schema: type: string example: 80 - name: rewrite_ssl_port_enabled in: query description: Boolean value to indicate whether the default SSL port should be rewritten or not required: true schema: type: boolean example: true - name: ssl_port in: query description: The port number to rewrite default SSL port to schema: type: string example: 443 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/rewrite-port: post: tags: - Site Management summary: Get Rewrite Port description: Use this operation to get the rewritten port number used to access the origin server. operationId: getRewritePorts parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultGetRewritePorts' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/error-page/modify: post: tags: - Site Management summary: Modify Error Page description: Use this operation to set a custom error page for a given site. operationId: modifySiteErrorPageTemplate parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: error_page_template in: query description: The error page html template. $TITLE$ and $BODY$ placeholders are required. required: true schema: type: string responses: '200': description: res - contains the specific error code:
2 - Invalid input
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/performance/error-page: post: tags: - Site Management summary: Get Error Page description: Use this operation to get the custom error page for a given site. operationId: getSiteErrorPageTemplate parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/status: post: tags: - Site Management summary: Get Site Status description: Use this operation to get the status of a site. operationId: siteStatus parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: tests in: query description: 'List of tests to run on site before returning its status.
A comma separated list of one of: domain_validation, services, dns
Values for the stats parameters:
' schema: type: string example: domain_validation responses: '200': description: res - contains the specific error code:
3001 - Domain invalid
6002 - Invalid configuration parameter value
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/list: post: tags: - Site Management summary: List Sites description: List sites for an account operationId: listSites parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters.
If the account has sub accounts, the operation returns results for the sites in the account and in all of its sub accounts. schema: type: string example: 15 - name: page_size in: query description: 'The number of objects to return in the response. Default is 50. Maximum: 100' schema: type: string example: 2 - name: page_num in: query description: he page to return starting from 0. Default is 0 schema: type: string example: 1 responses: '200': description: res - contains the specific error code:
1 - Unexpected error content: application/json: schema: $ref: '#/components/schemas/ApiResultListSites' /api/prov/v1/domain/emails: post: tags: - Site Management summary: Get Domain Approver E-mail Addresses description: Use this operation to get the list of email addresses that can be used when adding an SSL site. operationId: domainEmails parameters: - name: domain in: query description: 'The domain name of the site. For example: www.example.com, www.example.com, www.example.com' required: true schema: type: string example: www.example.com responses: '200': description: res - contains the specific error code:
3001 - Domain invalid
3011 - Site unresolvable content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultDomainEmails' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/setlog: post: tags: - Site Management summary: Modify Site Logs Level description: Use this operation to change the site log configuration. operationId: modifySiteLogLevel parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: log_level in: query description: 'Available only for customers that purchased the Logs Integration SKU. Sets the log reporting level for the site.
Possible values: full, security, none, default' required: true schema: type: string example: full - name: logs_account_id in: query description: Available only for customers that purchased the Logs Integration SKU. Numeric identifier of the account that purchased the logs integration SKU and which collects the logs.
If not specified, operation will be performed on the account identified by the authentication parameters schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
2 - Invalid input
6002 - Invalid configuration parameter name
6001 - Invalid configuration parameter name
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/tls: post: tags: - Site Management summary: Set support for all TLS versions description: Use this operation to support all TLS versions for the site for connectivity between clients (visitors) and the Imperva service. To remain PCI-compliant, do not enable this option. operationId: modifySiteSupportDeprecatedTLS parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 10 - name: support_all_tls_versions in: query description: 'Support all TLS versions. Default value: false' required: true schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
5 - Operation unavailable
9415 - Operation not allowed
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSetSupportDeprecatedTLSForSite' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/configure: post: tags: - Site Management summary: Modify Site Configuration description: Use this operation to change one of the basic configuration settings of the site. operationId: modifySiteConfiguration parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: example.imperva.com - name: param in: query description: 'Name of configuration parameter to set.
Parameter values:
' required: true schema: type: string example: active - name: value in: query description: According to the param value. required: true schema: type: string example: bypass responses: '200': description: res - contains the specific error code:
3015 - Internal error
6001 - Invalid configuration parameter name
6002 - Invalid configuration parameter value
1 - Unexpected error
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/delete: post: tags: - Site Management summary: Delete Site description: Delete the site. operationId: deleteSite parameters: - name: site_id in: query description: Numeric identifier of the site to operate on schema: type: string example: 15 responses: '200': description: res - contains the specific error code:
1 - Unexpected error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/add: post: tags: - Site Management summary: Add a Site description: Add a new site to an account. If the site already exists, its status is returned. operationId: addSite parameters: - name: domain in: query description: 'The domain name of the site. For example: www.example.com, www.example.com, www.example.com' required: true schema: type: string example: example.imperva.com - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. schema: type: string example: 10 - name: ref_id in: query description: Customer specific identifier for this operation schema: type: string example: 11 - name: send_site_setup_emails in: query description: If this value is false, end users will not get emails about the add site process such as DNS instructions and SSL setup. schema: type: string example: false - name: site_ip in: query description: Manually set the web server IP/CNAME schema: type: string example: 1.2.3.4 - name: force_ssl in: query description: If this value is true, manually set the site to support SSL.
This option is only available for sites with manually configured IP/CNAME and for specific accounts. schema: type: string example: true - name: naked_domain_san in: query description: 'Use “true” to add the naked domain SAN to a www site’s SSL certificate. Default value: true' schema: type: string example: true - name: wildcard_san in: query description: 'Use “true” to add the wildcard SAN or “false” to add the full domain SAN to the site’s SSL certificate. Default value: true' schema: type: string example: true - name: log_level in: query description: Available only for customers that purchased the Logs Integration SKU.
Sets the log reporting level for the site. Options are “full”, “security”, “none” and default schema: type: string example: full - name: logs_account_id in: query description: Available only for customers that purchased the Logs Integration SKU.
Numeric identifier of the account that purchased the logs integration SKU and which collects the logs.
If not specified, operation will be performed on the account identified by the authentication parameters schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
3001 - Domain invalid
3002 - Site is on the CloudFlare network
3003 - Site requires SSL
3004 - Domain belongs to a known service
3005 - Site is on a service
3006 - Site requires multiple IPs support
3011 - Site unresolvable
3012 - Site unreachable
3013 -Site already protected by the service
3014 - Number of allowed sites exceeded.
3015 - Internal error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/configure/acl: post: tags: - Site Management summary: Modify Site Access Control List (ACL) Configuration description: Use this operation to change the ACL configuration of a site. To modify the configuration for a specific ACL rule, its values are required, as documented below. To delete an entire ACL list, send an empty string as the list values. operationId: modifySiteAclConfiguration parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 15 - name: rule_id in: query description: The id of the acl, e.g api.acl.blacklisted_ips.
Values for the rule_id parameter:
required: true schema: type: string example: 548723 - name: urls in: query description: A comma separated list of resource paths. For example, /home and /admin/index.html are resource paths, however http://www.example.com/home is not. Each URL should be encoded separately using percent encoding as specified by RFC 3986 (http://tools.ietf.org/html/rfc3986#section-2.1). An empty URL list will remove all URLs schema: type: string example: /home - name: url_patterns in: query description: 'A comma separated list of url patterns, one of: contains | equals | prefix | suffix | not_equals | not_contain | not_prefix | not_suffix. The patterns should be in accordance with the matching urls sent by the urls parameter' schema: type: string example: contains - name: countries in: query description: A comma separated list of country codes schema: type: string example: US - name: continents in: query description: A comma separated list of continent codes schema: type: string example: SA - name: ips in: query description: 'A comma separated list of IPs or IP ranges, e.g: 192.168.1.1, 192.168.1.1-192.168.1.100 or 192.168.1.1/24' schema: type: string example: 192.168.1.1/24 responses: '200': description: res - contains the specific error code:
2 - Invalid input
1 - Unexpected error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/data-privacy/show: post: tags: - Site Management summary: Get Site Data Storage Region description: Use this operation to get the site data region. operationId: getDataRegion parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9415 - Operation not allowed
14002 - No region for account content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSetDataRegion' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/configure/allowlist: post: tags: - Site Management summary: Modify Allow Lists Configuration description: Use this operation to set allow lists to security rules or ACLs. To update an existing allow list, send its ID in the id parameter. If the id parameter does not exist a new allow list will be created. operationId: modifySiteAllowListsConfiguration parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: string example: 15 - name: rule_id in: query description: The id of the rule (either a security or an acl rule), e.g api.threats.sql_injection, api.threats.cross_site_scripting, api.threats.illegal_resource_access required: true schema: type: string example: 548723 - name: allowlist_id in: query description: The id (an integer) of the allow list to be set. This field is optional - in case no id is supplied, a new allow list will be created. required: true schema: type: string example: 433245 - name: delete_allowlist in: query description: An optional boolean parameter. If it is set to "true" and a allow list id is sent, the allow list will be deleted. schema: type: string example: false - name: urls in: query description: A comma separated list of resource paths.
For example, /home and /admin/index.html are resource paths, while http://www.example.com/home is not.
Each URL should be encoded separately using percent encoding as specified by RFC 3986 (http://tools.ietf.org/html/rfc3986#section-2.1).
An empty URL list will remove all URLs. schema: type: string example: /home - name: countries in: query description: A comma separated list of country codes. schema: type: string example: US - name: continents in: query description: A comma separated list of continent codes. schema: type: string example: SA - name: ips in: query description: 'A comma separated list of IPs or IP ranges, e.g: 192.168.1.1, 192.168.1.1-192.168.1.100 or 192.168.1.1/24' schema: type: string example: 192.168.1.1/24 - name: client_app_types in: query description: A comma separated list of client application types schema: type: string example: Browser - name: client_apps in: query description: A comma separated list of client application IDs. schema: type: string example: 3 - name: parameters in: query description: A comma separated list of encoded parameters. schema: type: string - name: user_agents in: query description: A comma separated list of encoded user agents. schema: type: string example: Googlebot-2.1 - name: exception_id_only in: query description: Return only the new/edited exception id. schema: type: string example: true responses: '200': description: res - contains the specific error code:
2 - Invalid input. content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/configure/security: post: tags: - Site Management summary: Modify Site Security Configuration description: Use this operation to change the security configuration of a site. To modify the configuration for a specific rule, additional parameters may be required, as documented below. operationId: modifySiteSecurityConfiguration parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 15 - name: rule_id in: query description: ID of the security rule to change.
Values for the rule_id parameter:
required: true schema: type: string example: 578942 - name: block_bad_bots in: query description: 'Whether or not to block bad bots. Possible values: true, false' schema: type: string example: true - name: challenge_suspected_bots in: query description: 'Whether or not to send a challenge to clients that are suspected to be bad bots (CAPTCHA for example). Possible values: true, false' schema: type: string example: true - name: activation_mode in: query description: 'Possible values: off, auto, on
The syntax is as follows:.activation_mode. For example, for ''off'', use ''activation_mode=api.threats.ddos.activation_mode.off.
Note: This parameter is relevant and required for a DDoS rule only -- where rule_id=api.threats.ddos.' schema: type: string example: 'off' - name: security_rule_action in: query description: The action that should be taken when a threat is detected, for example:
api.threats.action.block_ip. Different actions are allowed per different threats, e.g. backdoors may only be quarantined, ignored, or trigger an alert.
Values for the security_rule_action parameter:
schema: type: string example: api.threats.action.alert - name: quarantined_urls in: query description: 'Removes quarantined URLs from the backdoor protection list, as defined in the Cloud Security Console Website Settings > WAF Settings > Backdoor Protect.
To remove a URL from the backdoor protection list, use the following parameters with the specified values:
quarantined_urls:
rule_id: api.threats.backdoor
security_rule_action: api.threats.action.quarantine_url' schema: type: string example: www.example.com - name: ddos_traffic_threshold in: query description: Consider site to be under DDoS if the request rate is above this threshold.
The valid values are 10, 20, 50, 100, 200, 500, 750, 1000, 2000, 3000, 4000, 5000 schema: type: integer format: int64 example: 1500 responses: '200': description: res - contains the specific error code:
9414 - Feature not permitted
9415 - Operation not allowed
2 - Invalid input content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSiteStatus' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/report: post: tags: - Site Management summary: Get Site Report description: Use this operation to get a report for a site. Reports are sent using Base64 encoding. operationId: getSiteReport parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: report in: query description: 'The report to get. One of: pci-compliance' required: true schema: type: string example: pci-compliance - name: format in: query description: 'The format to get the report in. One of: pdf | html' required: true schema: type: string example: pdf - name: time_range in: query description: 'Time range to fetch data for.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
  • today Retrieve data from midnight today until the current time.
  • last_7_days Retrieve data from midnight of 7 days ago until the current time.
  • last_30_days Retrieve data from midnight of 30 days ago until the current time.
  • last_90_days Retrieve data from midnight of 90 days ago until the current time.
  • month_to_date Retrieve data from midnight of the first day of the month until the current time.
  • custom Specify a custom time range using two additional parameters: start and end.
    Results are provided for full days only, starting from midnight. A time range of less than 24 hours gives results for the full day.
    For example:
    • A time range of 14:00 - 20:00 yesterday gives results for all of yesterday (midnight to midnight) - a full day.
    • A time range of 14:00 last Tuesday to 14:00 last Wednesday gives results for all of Tuesday and Wednesday - two full days.
    • A time range of 14:00 yesterday to 14:00 today gives results for all of yesterday starting from midnight until the current time today.
' required: true schema: type: string example: last_7_days - name: start in: query description: 'Start date in milliseconds since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
  • today Retrieve data from midnight today until the current time.
  • last_7_days Retrieve data from midnight of 7 days ago until the current time.
  • last_30_days Retrieve data from midnight of 30 days ago until the current time.
  • last_90_days Retrieve data from midnight of 90 days ago until the current time.
  • month_to_date Retrieve data from midnight of the first day of the month until the current time.
  • custom Specify a custom time range using two additional parameters: start and end.
    Results are provided for full days only, starting from midnight. A time range of less than 24 hours gives results for the full day.
    For example:
    • A time range of 14:00 - 20:00 yesterday gives results for all of yesterday (midnight to midnight) - a full day.
    • A time range of 14:00 last Tuesday to 14:00 last Wednesday gives results for all of Tuesday and Wednesday - two full days.
    • A time range of 14:00 yesterday to 14:00 today gives results for all of yesterday starting from midnight until the current time today.
' schema: type: string example: 1610356734 - name: end in: query description: 'End date in milliseconds since 1970.
Some operations require the user to specify a time range. This is done via the time_range parameter, which accepts the following values:
  • today Retrieve data from midnight today until the current time.
  • last_7_days Retrieve data from midnight of 7 days ago until the current time.
  • last_30_days Retrieve data from midnight of 30 days ago until the current time.
  • last_90_days Retrieve data from midnight of 90 days ago until the current time.
  • month_to_date Retrieve data from midnight of the first day of the month until the current time.
  • custom Specify a custom time range using two additional parameters: start and end.
    Results are provided for full days only, starting from midnight. A time range of less than 24 hours gives results for the full day.
    For example:
    • A time range of 14:00 - 20:00 yesterday gives results for all of yesterday (midnight to midnight) - a full day.
    • A time range of 14:00 last Tuesday to 14:00 last Wednesday gives results for all of Tuesday and Wednesday - two full days.
    • A time range of 14:00 yesterday to 14:00 today gives results for all of yesterday starting from midnight until the current time today.
' schema: type: string example: 1610356734 responses: '200': description: res - contains the specific error code:
5001 - Report invalid
5002 - Format invalid content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultReport' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/hostname/purge: post: tags: - Site Management summary: Purge Hostname from Cache description: Use this operation to purge the hostname from the cache. This API is for customers who use the same CNAME provided by Imperva for multiple hostnames and would like to change the CNAME for a particular hostname. Purging the hostname is required for the CNAME change to take effect. operationId: purgeHostname parameters: - name: host_name in: query description: The hostname to purge from the cache schema: type: string example: example.com responses: '200': description: res - contains the specific error code:
2 - Invalid input
3015 - Internal error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/htmlinjections: post: tags: - Site Management summary: Get HTML Injection Rules description: Use this operation to list all the HTML Injection rules operationId: getHtmlInjectionRules parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 15 responses: '200': description: Success content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultHtmlInjections' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/configure/htmlInjections: post: tags: - Site Management summary: Add, Replace or Remove a HTML Injection Rule description: Use this operation to add a new HTML injection rule, or to replace or remove an existing rule. operationId: setHtmlInjectionRule parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 15 - name: url in: query description: The URL where the content is injected required: true schema: type: string example: /home - name: url_pattern in: query description: 'The url pattern. One of: contains | not_contains | equals | not_equals | prefix | suffix | not_prefix | not_suffix' required: true schema: type: string example: contains - name: location in: query description: The location of the injection inside the URL ('head' or 'body_end') required: true schema: type: string example: head - name: content in: query description: The injected HTML snippet, Base64-encoded schema: type: string example: SGVsbG8gV29ybGQh - name: delete_content in: query description: 'Whether or not to delete existing HTML content.
Possible values: true/false' schema: type: boolean example: false responses: '200': description: res - contains the specific error code:
2 - Invalid input content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultHtmlInjections' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/customCertificate/upload: post: tags: - Site Management summary: Upload Custom Certificate description: 'Use this operation to upload custom certificate for your site. The following SSL certificate file formats are supported: PFX, PEM, CER.' operationId: uploadCustomCertificate parameters: - name: site_id in: query description: Numeric identifier of the site to operate on schema: type: integer format: int64 example: 10 - name: certificate in: query description: The certificate file in base64 format required: true schema: type: string - name: private_key in: query description: The private key of the certificate in base64 format. Optional in case of PFX certificate file format required: true schema: type: string - name: passphrase in: query description: "The passphrase used to protect your SSL certificate\t" schema: type: string responses: '200': description: res - contains the specific error code:
2 - Invalid input
4205 - Site does not have SSL
9414 - Feature not permitted
9414 - Feature not permitted
3015 - Internal error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/customCertificate/remove: post: tags: - Site Management summary: Remove Custom Certificate description: Use this operation to remove custom certificate. operationId: removeCustomCertificate parameters: - name: site_id in: query description: Numeric identifier of the site to operate on schema: type: integer format: int64 example: 5437773 responses: '200': description: res - contains the specific error code:
2 - Invalid input
4205 - Site does not have SSL
9414 - Feature not permitted
9414 - Feature not permitted
3015 - Internal error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/customCertificate/csr: post: tags: - Site Management summary: Create New CSR description: Use this operation to create a certificate signing request (CSR) for your site. operationId: createNewCSR parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: integer format: int64 example: 10 - name: email in: query description: 'Email address. For example: joe@example.com' schema: type: string example: joe@example.com - name: country in: query description: The two-letter ISO code for the country where your organization is located schema: type: string example: IL - name: state in: query description: The state/region where your organization is located. This should not be abbreviated schema: type: string example: IL - name: city in: query description: The city where your organization is located schema: type: string example: JER - name: organization in: query description: The legal name of your organization. This should not be abbreviated or include suffixes such as Inc., Corp., or LLC schema: type: string example: imperva - name: organization_unit in: query description: The division of your organization handling the certificate. For example, IT Department schema: type: string example: IT Department responses: '200': description: res - contains the specific error code:
2 - Invalid input
4205 - Site does not have SSL
9414 - Feature not permitted
9414 - Feature not permitted
3015 - Internal error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/data-privacy/region-change: post: tags: - Site Management summary: Set Site Data Storage Region description: Use this operation to set the site data region. operationId: setDataRegion parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: data_storage_region in: query description: The data region to use. required: true schema: type: string example: US responses: '200': description: res - contains the specific error code:
2 - Invalid input
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultSetDataRegion' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/data-privacy/show-override-by-geo: post: tags: - Site Management summary: List Available PoPs for Denylist/Allowlist description: Use this operation to list all PoPs that are available to add to a site’s blacklist or allowlist. operationId: getOverrideSiteRegionsByGeo responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/data-privacy/override-by-geo: post: tags: - Site Management summary: Set Site Regions by Origin Geolocation description: Use this operation to set the data storage region for each new site based on the geolocation of the origin server. operationId: setOverrideSiteRegionsByGeo parameters: - name: account_id in: query description: Numeric identifier of the account to operate on.
If not specified, operation will be performed on the account identified by the authentication parameters. required: true schema: type: string example: 10 - name: override_site_regions_by_geo in: query description: A boolean parameter. If it is set to "true", the data storage region for each new site will be based on the geolocation of the origin server. required: true schema: type: boolean example: 10 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9415 - Operation not allowed content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/caa/check-compliance: post: tags: - Site Management summary: Check CAA compliance description: Check site’s associated SANs for CAA compliance. If a given SAN is compliant, its SSL domain validation status is updated accordingly.This operation returns an updated list of the site’s associated SANs that are not compliant. An empty list indicates that all SANs are compliant. operationId: checkCAACompliance parameters: - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CaaComplianceCheckResult' /api/prov/v1/sites/moveSite: post: tags: - Site Management summary: Move site description: Use this operation to move a site from its account to another account. operationId: moveSite parameters: - name: site_id in: query description: Numeric identifier of the site to move required: true schema: type: integer format: int64 example: 10 - name: destination_account_id in: query description: The numeric identifier of the account which the site will be moved to required: true schema: type: integer format: int64 example: 15 responses: '200': description: res - contains the specific error code:
9415 - Operation not allowed content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultMoveSite' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/incapRules/priority/set: post: tags: - Site Management summary: Set Rule Priority description: Use this operation to change delivery rule's priority. operationId: setPriority parameters: - name: rule_id in: query description: Rule ID required: true schema: type: integer format: int64 example: 534663 - name: priority in: query description: New priority for the selected rule required: true schema: type: integer format: int32 example: 1 responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
2 - Invalid input content: application/json: schema: $ref: '#/components/schemas/SetPriorityResponse' /api/prov/v1/sites/incapRules/edit: post: tags: - Site Management summary: Edit Rule description: Use this operation to edit an existing rule (Delivery, Security or Rate). operationId: editCustomRule parameters: - name: action in: query description: Rule action.

Possible action parameter values for Delivery Rules:
  • RULE_ACTION_REDIRECT Redirect the client to a different URL, responding with a 30X response.
  • RULE_ACTION_SIMPLIFIED_REDIRECT Redirect the client to a different URL, responding with a 30X response.
  • RULE_ACTION_REWRITE_URL Modify the path to which a specific request is targeted.
  • RULE_ACTION_REWRITE_HEADER Modify or add a request header before passing traffic to the origin server.
  • RULE_ACTION_REWRITE_COOKIE Modify or add cookies that are sent by the client to the origin server. The cookie name and value should be indicated.
  • RULE_ACTION_DELETE_HEADER Remove a specific request header, which means that it won’t be sent to the origin server.
  • RULE_ACTION_DELETE_COOKIE Remove a specific cookie set on the client, which means that it won’t be sent to the origin server.
  • RULE_ACTION_FORWARD_TO_DC Define the data center to which a specific request will be sent.
  • RULE_ACTION_FORWARD_TO_PORT Define the port to which a specific request will be sent.
  • RULE_ACTION_RESPONSE_REWRITE_HEADER Modify or add a header to the response received from the origin server.
  • RULE_ACTION_RESPONSE_DELETE_HEADER Remove a specific response header, which means that it won't be returned to the client.
  • RULE_ACTION_RESPONSE_REWRITE_RESPONSE_CODE Modify the response code received from the origin server.

Possible action parameter values for security rules:
  • RULE_ACTION_ALERT Generate a non blocking alert for this event.
  • RULE_ACTION_BLOCK Block the current request and generate an alert for this event.
  • RULE_ACTION_BLOCK_USER Block the current session and generate an alert for this event. Any subsequent request from the same Session will be blocked.
  • RULE_ACTION_BLOCK_IP Block the current session and generate an alert for this event. Any subsequent request from the same Session will be blocked.
  • RULE_ACTION_RETRY Require any client matching the rule filters to support cookies in order to complete the request.
  • RULE_ACTION_INTRUSIVE_HTML Require any client matching the rule filters to support javascript in order to complete the request. Since the Javascript test is embedded in an HTML page, this action should only be enabled for HTML resources.
  • RULE_ACTION_CAPTCHA Require any client matching the rule filters to pass a CAPTCHA test in order to complete the request. Since the CAPTCHA test is embedded in an HTML page, this action should only be enabled for HTML resources.

Possible action parameter values for counter (rate) rules:
  • RULE_ACTION_RATE Count the number of requests received that match the rule filter.
schema: type: string example: RULE_ACTION_EXCLUDE - name: rule_id in: query description: Rule ID. required: true schema: type: integer format: int64 example: 10 - name: name in: query description: Rule name. schema: type: string example: rule1 - name: filter in: query description: Rule will trigger only a request that matches this filter. For more details on filter guidelines, see Syntax Guide. schema: type: string example: == - name: response_code in: query description: Redirect rule's response code. Valid values are 302, 301, 303, 307, 308. schema: type: integer format: int32 example: 1 - name: protocol in: query schema: type: string example: 10 - name: add_missing in: query description: Add cookie or header if it doesn't exist (Rewrite cookie rule only) schema: type: boolean example: true - name: from in: query description: The pattern to rewrite.
For RULE_ACTION_REWRITE_URL - The URL to rewrite.
For RULE_ACTION_REWRITE_HEADER - The header value to rewrite.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to rewrite.
For RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different URL, responding with a 30X response. schema: type: string example: /home.php - name: to in: query description: The pattern to change to.
For RULE_ACTION_REWRITE_URL - The URL to change to.
For RULE_ACTION_REWRITE_HEADER - The header value to change to.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to change to.
For RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different URL, responding with a 30X response. schema: type: string example: '*/home.html' - name: rewrite_name in: query description: Name of cookie or header to rewrite. Applies only for RULE_ACTION_REWRITE_COOKIE and RULE_ACTION_REWRITE_HEADER. schema: type: string example: rule2 - name: dc_id in: query description: Data center to forward request to. Applies only for RULE_ACTION_FORWARD_TO_DC. schema: type: integer format: int64 example: 54313 - name: allow_caching in: query schema: type: boolean example: true - name: rate_context in: query description: 'The context of the rate counter. Possible values: IP / Session. Applies only to rules using RULE_ACTION_RATE.' schema: type: string example: IP - name: rate_interval in: query description: 'The interval (in seconds) of the rate counter. Possible values: A multiple of 10 from 10-300. Applies only to rules using RULE_ACTION_RATE.' schema: type: integer format: int32 example: 5 - name: is_test_mode in: query description: Make rule apply only for IP address the API request was sent from.
This option is not available for Simplified Redirect rules. schema: type: boolean example: true - name: port_forwarding_context in: query description: Context for port forwarding. "Use Port Value" or "Use Header Name". Applies only for RULE_ACTION_FORWARD_TO_PORT. schema: type: string - name: port_forwarding_value in: query description: Port number or header name for port forwarding. Applies only for RULE_ACTION_FORWARD_TO_PORT. schema: type: string example: 20 - name: multiple_deletions in: query description: Delete multiple header occurrences. Applies only to rules using RULE_ACTION_DELETE_HEADER and RULE_ACTION_RESPONSE_DELETE_HEADER. schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
2 - Timerange invalid, 9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
3015 - Internal error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/incapRules/add: post: tags: - Site Management summary: Add Rule description: Use this operation to add a rule (Delivery, Security or Rate). operationId: addCustomRule parameters: - name: action in: query description: Rule action. See the possible values in the table below.
Possible action parameter values for Delivery Rules:
  • RULE_ACTION_REDIRECT Redirect the client to a different URL, responding with a 30X response.
  • RULE_ACTION_SIMPLIFIED_REDIRECT Redirect the client to a different URL, responding with a 30X response.
  • RULE_ACTION_REWRITE_URL Modify the path to which a specific request is targeted.
  • RULE_ACTION_REWRITE_HEADER Modify or add a request header before passing traffic to the origin server.
  • RULE_ACTION_REWRITE_COOKIE Modify or add cookies that are sent by the client to the origin server. The cookie name and value should be indicated.
  • RULE_ACTION_DELETE_HEADER Remove a specific request header, which means that it won’t be sent to the origin server.
  • RULE_ACTION_DELETE_COOKIE Remove a specific cookie set on the client, which means that it won’t be sent to the origin server.
  • RULE_ACTION_FORWARD_TO_DC Define the data center to which a specific request will be sent.
  • RULE_ACTION_FORWARD_TO_PORT Define the port to which a specific request will be sent.
  • RULE_ACTION_RESPONSE_REWRITE_HEADER Modify or add a header to the response received from the origin server.
  • RULE_ACTION_RESPONSE_DELETE_HEADER Remove a specific response header, which means that it won't be returned to the client.
  • RULE_ACTION_RESPONSE_REWRITE_RESPONSE_CODE Modify the response code received from the origin server.

Possible action parameter values for security rules:
  • RULE_ACTION_ALERT Generate a non blocking alert for this event.
  • RULE_ACTION_BLOCK Block the current request and generate an alert for this event.
  • RULE_ACTION_BLOCK_USER Block the current session and generate an alert for this event. Any subsequent request from the same Session will be blocked.
  • RULE_ACTION_BLOCK_IP Block the current session and generate an alert for this event. Any subsequent request from the same Session will be blocked.
  • RULE_ACTION_RETRY Require any client matching the rule filters to support cookies in order to complete the request.
  • RULE_ACTION_INTRUSIVE_HTML Require any client matching the rule filters to support javascript in order to complete the request. Since the Javascript test is embedded in an HTML page, this action should only be enabled for HTML resources.
  • RULE_ACTION_CAPTCHA Require any client matching the rule filters to pass a CAPTCHA test in order to complete the request. Since the CAPTCHA test is embedded in an HTML page, this action should only be enabled for HTML resources.

Possible action parameter values for counter (rate) rules:
  • RULE_ACTION_RATE Count the number of requests received that match the rule filter.
required: true schema: type: string example: RULE_ACTION_EXCLUDE - name: site_id in: query description: Numeric identifier of the site to operate on. required: true schema: type: integer format: int64 example: 10 - name: name in: query description: Rule name. required: true schema: type: string example: rule1 - name: filter in: query description: Rule will trigger only a request that matches this filter. For more details on filter guidelines, see Syntax Guide.
The filter may contain up to 400 characters. required: true schema: type: string example: == - name: response_code in: query description: Redirect rule's response code. Valid values are 302, 301, 303, 307, 308. schema: type: integer format: int32 example: 1 - name: protocol in: query schema: type: string example: 10 - name: add_missing in: query description: Add cookie or header if it doesn't exist (Rewrite cookie rule only) schema: type: boolean example: true - name: from in: query description: The pattern to rewrite.
For RULE_ACTION_REWRITE_URL - The URL to rewrite.
For RULE_ACTION_REWRITE_HEADER - The header value to rewrite.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to rewrite.
For RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different URL, responding with a 30X response. schema: type: string example: /home.php - name: to in: query description: The pattern to change to.
For RULE_ACTION_REWRITE_URL - The URL to change to.
For RULE_ACTION_REWRITE_HEADER - The header value to change to.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to change to.
For RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different URL, responding with a 30X response. schema: type: string example: '*/home.html' - name: rewrite_name in: query description: Name of cookie or header to rewrite. Applies only for RULE_ACTION_REWRITE_COOKIE and RULE_ACTION_REWRITE_HEADER. schema: type: string example: rule2 - name: dc_id in: query description: Data center to forward request to. Applies only for RULE_ACTION_FORWARD_TO_DC. schema: type: integer format: int64 example: 54313 - name: allow_caching in: query schema: type: boolean example: true - name: is_test_mode in: query description: Apply the rule only to the IP address the API request was sent from.
This option is not available for Simplified Redirect rules. schema: type: boolean example: true - name: rate_context in: query description: 'The context of the rate counter. Possible values: IP / Session. Applies only to rules using RULE_ACTION_RATE.' schema: type: string example: Session - name: rate_interval in: query description: 'The interval (in seconds) of the rate counter. Possible values: A multiple of 10 from 10-300. Applies only to rules using RULE_ACTION_RATE.' schema: type: integer format: int32 example: 10 - name: port_forwarding_context in: query description: Context for port forwarding. "Use Port Value" or "Use Header Name". Applies only for RULE_ACTION_FORWARD_TO_PORT. schema: type: string - name: port_forwarding_value in: query description: Port number or header name for port forwarding. Applies only for RULE_ACTION_FORWARD_TO_PORT. schema: type: string example: 20 - name: multiple_deletions in: query description: Delete multiple header occurrences. Applies only to rules using RULE_ACTION_DELETE_HEADER and RULE_ACTION_RESPONSE_DELETE_HEADER. schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
2 - Invalid input, 3015 - Granularity invalid content: application/json: schema: $ref: '#/components/schemas/CustomRuleResponse' /api/prov/v1/sites/incapRules/enableDisable: post: tags: - Site Management summary: Enable or Disable Rule description: Use this operation to enable or disable a rule (Delivery, Security or Rate). operationId: enableDisableCustomRule parameters: - name: rule_id in: query description: Rule id required: true schema: type: integer format: int64 example: 10 - name: enable in: query description: When true, the rule will be enabled. Set to false to disable required: true schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
2 - Timerange invalid, 9413 - Unknown/unauthorized site_id
9415 - Operation not allowed
3015 - Internal error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/sites/incapRules/delete: post: tags: - Site Management summary: Delete Data Center description: Use this operation to delete site datacenter. operationId: deleteCustomRule parameters: - name: rule_id in: query description: Rule id required: true schema: type: integer format: int64 example: 4356 responses: '200': description: res - contains the specific error code:
2 - Timerange invalid, 9413 - Unknown/unauthorized site_id content: application/json: schema: $ref: '#/components/schemas/DeleteCustomRuleResponse' /api/prov/v1/sites/incapRules/list: post: tags: - Site Management summary: List Rules description: Use this operation to list security, delivery, and rate rules for a given site. operationId: listCustomRules parameters: - name: site_id in: query description: Numeric identifier of the site to operate on required: true schema: type: string example: 10 - name: include_incap_rules in: query description: Whether or not security rules be included. Defaults to "Yes". schema: type: string example: true - name: include_ad_rules in: query description: Whether or not delivery rules should be included. Defaults to Yes schema: type: string example: true - name: pageSize in: query description: The number of objects to return in the response. Defaults to 50. Maximum is 100 schema: type: string example: 10 - name: pageNum in: query description: The page to return starting from 0. Default to 0 schema: type: string example: 1 responses: '200': description: res - contains the specific error code:
2 - Invalid input, 9413 - Unknown/unauthorized site_id content: application/json: schema: $ref: '#/components/schemas/ListCustomRulesResponse' /api/prov/v1/sites/incapRules/account/list: post: tags: - Site Management summary: List Account Rules description: Use this operation to list rules (Delivery, Security or Rate) for all sites under a given account. operationId: listAccountCustomRules parameters: - name: account_id in: query description: Numeric identifier of the account to operate on required: true schema: type: integer format: int64 example: 10 - name: include_incap_rules in: query description: Whether or not security rules be included. Defaults to "Yes". schema: type: boolean example: true - name: include_ad_rules in: query description: Whether or not delivery rules should be included. Defaults to "Yes". schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
9413 - Unknown/unauthorized site_id
405 - Api is disabled content: application/json: schema: $ref: '#/components/schemas/ListCustomRulesResponse' /api/prov/v1/accounts/testS3Connection: post: tags: - Account Management summary: Test connection with S3 bucket description: Use this operation to check that a connection can be created with your Amazon S3 bucket. operationId: testConnectionS3 parameters: - name: account_id in: query description: Numeric identifier of the account to operate on required: true schema: type: string example: 10 - name: bucket_name in: query description: S3 bucket name required: true schema: type: string - name: access_key in: query description: S3 access key required: true schema: type: string - name: secret_key in: query description: S3 secret key required: true schema: type: string - name: save_on_success in: query description: Save this configuration if the test connection was successful. Default value:false schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account id
9414 - Feature not permitted
1- Unexpected error
6002- Invalid configuration parameter value content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/testSftpConnection: post: tags: - Account Management summary: Test connection with SFTP server description: Use this operation to check that a connection can be created with your SFTP storage. operationId: testConnectionSftp parameters: - name: account_id in: query description: Numeric identifier of the account to operate on. required: true schema: type: string example: 10 - name: host in: query description: The IP address of your SFTP server required: true schema: type: string example: 10.1.1.1 - name: user_name in: query description: A user name that will be used to log in to the SFTP server required: true schema: type: string example: John Doe - name: password in: query description: A corresponding password for the user account used to log in to the SFTP server required: true schema: type: string - name: destination_folder in: query description: The path to the directory on the SFTP server required: true schema: type: string - name: save_on_success in: query description: 'Save this configuration if the test connection was successful. Default value: false' schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account id
9414 - Feature not permitted
1- Unexpected error
6002- Invalid configuration parameter value content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/setDefaultSiemStorage: post: tags: - Account Management summary: Set Imperva servers for log storage description: Use this operation to have your logs saved on Incapsula servers. Once configured, the logs can be retrieved by API calls. operationId: setDefaultSiemStorage parameters: - name: account_id in: query description: Numeric identifier of the account to operate on required: true schema: type: string example: 10 responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account id
9414 - Feature not permitted
1- Unexpected error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/setAmazonSiemStorage: post: tags: - Account Management summary: Set S3 configuration for log storage description: Use this operation to configure your Amazon cloud storage. Once configured, Imperva logs will be uploaded to the selected location. operationId: setStorageToS3 parameters: - name: account_id in: query description: Numeric identifier of the account to operate on required: true schema: type: string example: 10 - name: bucket_name in: query description: S3 bucket name required: true schema: type: string - name: access_key in: query description: S3 access key required: true schema: type: string - name: secret_key in: query description: S3 secret key required: true schema: type: string responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account id
9414 - Feature not permitted
1- Unexpected error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/accounts/setSftpSiemStorage: post: tags: - Account Management summary: Set SFTP server configuration for log storage description: Use this operation to configure your SFTP server storage. Once configured, Incapsula logs will be uploaded to the selected location. operationId: setStorageToSftp parameters: - name: account_id in: query description: Numeric identifier of the account to operate on required: true schema: type: string example: 10 - name: host in: query description: The IP address of your SFTP server required: true schema: type: string example: 10.1.1.1 - name: user_name in: query description: A user name that will be used to log in to the SFTP server required: true schema: type: string example: John Doe - name: password in: query description: A corresponding password for the user account used to log in to the SFTP server required: true schema: type: string - name: destination_folder in: query description: The path to the directory on the SFTP server required: true schema: type: string responses: '200': description: res - contains the specific error code:
9403 - Unknown/unauthorized account id
9414 - Feature not permitted
1- Unexpected error content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/ddos/start: post: tags: - DDoS for Networks Test Alerts summary: DDoS Start description: Use this operation to send a test notification informing you that an Infrastructure Protection DDoS attack has started.
You can optionally provide additional parameters to determine the magnitude of the attack. operationId: postInfraProtectDdosStart parameters: - name: ip_prefix in: query description: The IP prefix to send a notification for. For example, 10.10.10.10 schema: type: string example: 100.1.2.0/24 - name: bps in: query description: Number of bits per second schema: type: integer format: int32 example: 8 - name: pps in: query description: Number of packets per second schema: type: integer format: int64 example: 16 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlert' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/ddos/stop: post: tags: - DDoS for Networks Test Alerts summary: DDoS Stop description: Use this operation to send a test notification informing you that an Infrastructure Protection DDoS attack has ended.
You can optionally provide additional parameters to determine the magnitude of the attack. operationId: postInfraProtectDdosStop parameters: - name: ip_prefix in: query description: The IP prefix to send a notification for. For example, 10.10.10.10 schema: type: string example: 100.1.2.0/24 - name: bps in: query description: Number of bits per second schema: type: integer format: int32 example: 8 - name: pps in: query description: Number of packets per second schema: type: integer format: int64 example: 16 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlert' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/connection/down: post: tags: - DDoS for Networks Test Alerts summary: Connection Down description: Use this operation to send a test notification informing you that the Infrastructure Protection connection is down.
You can optionally provide the name of the connection as it appears in the Management Console’s Protection Settings page. operationId: postInfraProtectTunnelDown parameters: - name: connection_name in: query description: The connection to send a notification for.
Enter the connection name as it appears in the Cloud Security Console’s Protection Settings page. For example, Test_GRE_Tunnel. schema: type: string example: CONNECTION_NAME responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlertConnectionStatus' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/connection/up: post: tags: - DDoS for Networks Test Alerts summary: Connection UP description: Use this operation to send a test notification informing you that the Infrastructure Protection connection is up.
You can optionally provide the name of the connection as it appears in the Management Console’s Protection Settings page. operationId: postInfraProtectTunnelUp parameters: - name: connection_name in: query description: The connection to send a notification for.
Enter the connection name as it appears in the Cloud Security Console’s Protection Settings page. For example, Test_GRE_Tunnel. schema: type: string example: CONNECTION_NAME responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlertConnectionStatus' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/ip-protection-status/up: post: tags: - DDoS for Networks Test Alerts summary: IP Protection Status Up description: Use this operation to send a test notification informing you that the IP Protection status is up. operationId: postProtectedIPStatusUp parameters: - name: ip_protection in: query description: The IP to send a notification for. For example, 10.10.10.10 schema: type: string example: 1.1.1.1 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlert' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/ip-protection-status/down: post: tags: - DDoS for Networks Test Alerts summary: IP Protection Status Down description: Use this operation to send a test notification informing you that the IP Protection status is down. operationId: postProtectedIPStatusDown parameters: - name: ip_protection in: query description: The IP to send a notification for. For example, 10.10.10.10 schema: type: string example: 1.1.1.1 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlertProtectedIPStatus' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/monitoring/start: post: tags: - DDoS for Networks Test Alerts summary: Monitoring Start description: Use this operation to send a test notification informing you that flow monitoring has started.
You can optionally provide the exporter IP found in the Management Console’s Monitoring Settings page. operationId: postInfraProtectNetFlowStart parameters: - name: exporter_ip in: query description: The exporter IP to send a notification for. For example, 10.10.10.10.
The exporter IP can be found in the Cloud Security Console’s Monitoring Settings page. schema: type: string example: 1.1.1.1 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlertExporterStatus' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/monitoring/stop: post: tags: - DDoS for Networks Test Alerts summary: Monitoring Stop description: Use this operation to send a test notification informing you that NetFlow monitoring has stopped. operationId: postInfraProtectNetFlowStop parameters: - name: exporter_ip in: query description: The exporter IP to send a notification for. For example, 10.10.10.10.
The exporter IP can be found in the Cloud Security Console’s Monitoring Settings page. schema: type: string example: 1.1.1.1 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlertExporterStatus' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/monitoring/bad-data: post: tags: - DDoS for Networks Test Alerts summary: Monitoring Bad Data description: Use this operation to send a test notification informing you that the monitoring service is receiving messages that do not conform to the accepted format.
You can optionally provide the exporter IP found in the Management Console’s Monitoring Settings page. operationId: postInfraProtectNetFlowBadData parameters: - name: exporter_ip in: query description: The exporter IP to send a notification for. For example, 10.10.10.10.
The exporter IP can be found in the Cloud Security Console’s Monitoring Settings page. schema: type: string example: 1.1.1.1 responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlertExporterStatus' - $ref: '#/components/schemas/ApiResult' /api/v1/infra-protect/test-alerts/monitoring/attack-start: post: tags: - DDoS for Networks Test Alerts summary: Monitoring Attack Start description: Use this operation to send a test notification informing you that the monitoring service has detected a DDoS attack.
You can optionally provide additional parameters to determine the magnitude of the attack. operationId: postInfraProtectMonitoringAttackStartCriticalAlert parameters: - name: ip_prefix in: query description: The IP range to send a notification for. For example, 1.1.1.0/24 schema: type: string example: 100.1.2.1 - name: bps in: query description: Number of bits per second schema: type: integer format: int32 example: 8 - name: pps in: query description: Number of packets per second schema: type: integer format: int64 example: 16 - name: packet_type in: query description: Packet type. (UDP, TCP, DNS, DNS_RESPONSE, ICMP, SYN, FRAG, LARGE_SYN, NTP, NETFLOW, SSDP, GENERAL) schema: type: string example: TCP responses: '200': description: res - contains the specific error code:
2 - Invalid input
9414 - Feature not permitted content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultTestAlert' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/add/ip: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Add by CNAME description: 'Use this operation to onboard a public origin IP to the ''IP Protection over TCP'' service. If successful, the operation will return the generated Edge IP.' operationId: addSipByIp parameters: - name: origin_ip in: query description: Public origin IP to onboard to service required: true schema: type: string example: 1.2.3.4 - name: enable_ha_protocol in: query description: Provide 'true' to enable the Proxy Protocol setting (disabled by default) schema: type: boolean example: true - name: description in: query description: description for the generated Edge IP schema: type: string - name: monitoring_type in: query description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default), ''TCP'' or ''NONE''' schema: type: string example: TCP - name: tcp_monitoring_port in: query description: Port to use for TCP monitoring of the Edge IP. Required only when TCP monitoring is used. schema: type: integer format: int32 example: 25 responses: '200': description: res - contains the specific error code:
3015 - Internal error
7002 - IP Protection quota exceeded
7003 - IP cannot be used
7007 - This entity is already protected content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipIp' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/add/cname: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Add by origin IP description: 'Use this operation to onboard a CNAME record to the ''IP Protection over TCP'' service. If successful, the operation will return the generated Edge IP.' operationId: addSipByCname parameters: - name: cname in: query description: CNAME record to onboard to service required: true schema: type: string example: imperva.test.com - name: enable_ha_protocol in: query description: Provide 'true' to enable the Proxy Protocol setting (disabled by default) schema: type: boolean example: true - name: description in: query description: Optional description for the generated Edge IP schema: type: string - name: monitoring_type in: query description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default), ''TCP'' or ''NONE''' schema: type: string example: TCP - name: tcp_monitoring_port in: query description: Port to use for TCP monitoring of the Edge IP. Required only when TCP monitoring is used. schema: type: integer format: int32 example: 25 responses: '200': description: res - contains the specific error code:
3015 - Internal error
7002 - IP Protection quota exceeded
7007 - This entity is already protected
7008 - CNAME cannot be used content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipCname' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/add/dns-with-ip: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Add by DNS and origin IP description: 'Use this operation to onboard a public origin IP with an associated DNS name to the ''IP Protection over TCP'' service. If DNS check is enabled, the response will include the list of resolved IPs for the provided domain name, and the operation will only succeed if the provided origin IP will be included in that list. If successful, the operation will return the generated Edge IP.' operationId: addSipByDnsAndIp parameters: - name: dns_name in: query description: Domain name to onboard to service required: true schema: type: string example: example.imperva.com - name: origin_ip in: query description: Public origin IP to onboard to service required: true schema: type: string example: 1.2.3.4 - name: disable_dns_check in: query description: Provide 'true' to disable DNS resolution check (enabled by default) schema: type: boolean example: true - name: enable_ha_protocol in: query description: Provide 'true' to enable the Proxy Protocol setting (disabled by default) schema: type: boolean example: true - name: description in: query description: description for the generated Edge IP schema: type: string - name: monitoring_type in: query description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default), ''TCP'' or ''NONE' schema: type: string example: TCP - name: tcp_monitoring_port in: query description: Port to use for TCP monitoring of the Edge IP. Required only when TCP monitoring is used. schema: type: integer format: int32 example: 25 responses: '200': description: res - contains the specific error code:
3015 - Internal error
7001 - IP not among DNS resolved records
7002 - IP Protection quota exceeded
7003 - IP cannot be used
7004 - Domain name cannot be used
7005 - No DNS records found
7007 - This entity is already protected content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithIp' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/add/dns-with-cname: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Add by DNS and CNAME description: 'Use this operation to onboard a CNAME record with an associated DNS name to the ''IP Protection over TCP'' service. If DNS check is enabled, the response will include the list of resolved CNAME records for the provided domain name, and the operation will only succeed if the provided CNAME will be included in that list. If successful, the operation will return the generated Edge IP.' operationId: addSipByDnsAndCname parameters: - name: dns_name in: query description: Domain name to onboard to service required: true schema: type: string example: example.imperva.com - name: cname in: query description: CNAME record to onboard to service required: true schema: type: string example: imperva.test.com - name: disable_dns_check in: query description: Provide 'true' to disable DNS resolution check (enabled by default) schema: type: boolean example: true - name: enable_ha_protocol in: query description: Provide 'true' to enable the Proxy Protocol setting (disabled by default) schema: type: boolean example: true - name: description in: query description: description for the generated Edge IP schema: type: string - name: monitoring_type in: query description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default), ''TCP'' or ''NONE' schema: type: string example: TCP - name: tcp_monitoring_port in: query description: Port to use for TCP monitoring of the Edge IP. Required only when TCP monitoring is used. schema: type: integer format: int32 example: 25 responses: '200': description: res - contains the specific error code:
3015 - Internal error
7002 - IP Protection quota exceeded
7004 - Domain name cannot be used
7005 - No DNS records found
7007 - This entity is already protected
7008 - CNAME cannot be used
7009 - CNAME not among DNS resolved records content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithCname' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/edit/ip: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Edit by origin IP description: 'Use this operation to assign a new origin IP to the provided Edge IP under the ''IP Protection over TCP'' service. This operation is also able to change the type of the entity protected by the provided Edge IP (Any existing combination of Origin IP/CNAME and DNS name will be overwritten). If successful, the operation will return the Edge IP. WARNING: Any entity already protected by this Edge IP prior to the change will no longer be protected once modification is successful, unless duplicate protection is used.' operationId: editSipByIp parameters: - name: edge_ip in: query description: Imperva generated Edge IP required: true schema: type: string example: 172.17.14.1 - name: origin_ip in: query description: Public origin IP to onboard to service required: true schema: type: string example: 1.2.3.4 responses: '200': description: res - contains the specific error code:
3015 - Internal error
7003 - IP cannot be used
7006 - Edge IP not found
7007 - This entity is already protected content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipIp' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/edit/cname: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Edit by CNAME description: 'Use this operation to assign a new CNAME record to the provided Edge IP under the ''IP Protection over TCP'' service. This operation is also able to change the type of the entity protected by the provided Edge IP (Any existing combination of Origin IP/CNAME and DNS will be overwritten). If successful, the operation will return the Edge IP. WARNING: Any entity already protected by this Edge IP prior to the change will no longer be protected once modification is successful, unless duplicate protection is used.' operationId: editSipByCname parameters: - name: edge_ip in: query description: Imperva generated Edge IP required: true schema: type: string example: 172.17.14.1 - name: cname in: query description: CNAME to onboard to service required: true schema: type: string example: imperva.test.com responses: '200': description: res - contains the specific error code:
3015 - Internal error
7003 - IP cannot be used
7006 - Edge IP not found
7007 - This entity is already protected
7008 - CNAME cannot be used content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipCname' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/edit/dns-with-ip: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Edit by DNS and origin IP description: 'Use this operation to assign a new origin IP with an associated DNS name to the provided Edge IP under the ''IP Protection over TCP'' service. This operation is also able to change the type of the entity protected by the provided Edge IP (Any existing combination of Origin IP/CNAME and DNS name will be overwritten). If DNS check is enabled, the response will include the list of resolved IPs for the provided domain name, and the operation will only succeed if the provided origin IP is included in that list. If successful, the operation will return the Edge IP. WARNING: Any entity already protected by this Edge IP prior to the change will no longer be protected once modification is successful, unless duplicate protection is used.' operationId: editSipByDnsAndIp parameters: - name: edge_ip in: query description: Imperva generated Edge IP required: true schema: type: string example: 172.17.14.1 - name: dns_name in: query description: Domain name to onboard to service required: true schema: type: string example: imperva.example.com - name: origin_ip in: query description: Public origin IP to onboard to service required: true schema: type: string example: 1.2.3.4 - name: disable_dns_check in: query description: Provide 'true' to disable DNS resolution check (enabled by default) schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
3015 - Internal error
7001 - IP not among DNS resolved records
7003 - IP cannot be used
7004 - Domain name cannot be used
7005 - No DNS records found
7006 - Edge IP not found
7007 - This entity is already protected content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithIp' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/edit/dns-with-cname: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Edit by DNS and origin IP description: 'Use this operation to assign a new CNAME record with an associated DNS name to the provided Edge IP under the ''IP Protection over TCP'' service.
This operation is also able to change the type of the entity protected by the provided Edge IP (Any existing combination of Origin IP/CNAME and DNS name will be overwritten).
If DNS check is enabled, the response will include the list of resolved CNAME records for the provided domain name, and the operation will only succeed if the provided CNAME is included in that list.
If successful, the operation will return the Edge IP.
WARNING: Any entity already protected by this Edge IP prior to the change will no longer be protected once modification is successful, unless duplicate protection is used.' operationId: editSipByDnsAndCname parameters: - name: edge_ip in: query description: Imperva generated Edge IP required: true schema: type: string example: 172.17.14.1 - name: dns_name in: query description: Domain name to onboard to service required: true schema: type: string example: imperva.example.com - name: cname in: query description: CNAME to onboard to service required: true schema: type: string example: imperva.example.com - name: disable_dns_check in: query description: Provide 'true' to disable DNS resolution check (enabled by default) schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
3015 - Internal error
7003 - IP cannot be used
7004 - Domain name cannot be used
7005 - No DNS records found
7006 - Edge IP not found
7007 - This entity is already protected
7008 - CNAME cannot be used
7009 - CNAME not among DNS resolved records content: application/json: schema: oneOf: - $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithCname' - $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/edit/ha-protocol: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Edit HA Protocol Setting description: 'Use this operation on the provided Edge IP to toggle its HA Protocol setting on or off. By default, this setting is disabled during onboarding unless explicitly set to ''true''. WARNING: Do not modify this setting unless you are familiar with the proxy protocol and understand the implications of enabling or disabling it for your account.' operationId: editSipHaProtocol parameters: - name: edge_ip in: query description: Imperva generated Edge IP required: true schema: type: string example: 172.17.14.1 - name: enable_ha_protocol in: query description: Provide 'true' to enable the Proxy Protocol setting, 'false' to disable required: true schema: type: boolean example: true responses: '200': description: res - contains the specific error code:
3015 - Internal error
7003 - IP cannot be used
7006 - Edge IP not found content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/edit/monitoring-settings: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Edit Monitoring Settings description: Use this operation on the specified Edge IP to modify its monitoring settings. operationId: editSipMonitoringSettings parameters: - name: edge_ip in: query description: Imperva generated Edge IP required: true schema: type: string example: 172.17.14.1 - name: monitoring_type in: query description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default), ''TCP'' or ''NONE''' required: true schema: type: string example: TCP - name: tcp_monitoring_port in: query description: Port to use for TCP monitoring of the Edge IP. Required only when TCP monitoring is used. schema: type: integer format: int32 example: 15 responses: '200': description: res - contains the specific error code:
3015 - Internal error
7003 - IP cannot be used
7006 - Edge IP not found content: application/json: schema: $ref: '#/components/schemas/ApiResult' /api/prov/v1/ddos-protection/edge-ip/remove: post: tags: - DDoS Protection for Individual IPs summary: Protected IP over TCP - Remove description: 'Use this operation on the provided Edge IP to remove it from the ''IP Protection over TCP'' service.
WARNING: Any entity already protected by this Edge IP will no longer be protected once the operation is successful, unless duplicate protection was enabled and used.' operationId: removeSip parameters: - name: edge_ip in: query description: Imperva generated Edge IP required: true schema: type: string example: 172.17.14.1 responses: '200': description: res - contains the specific error code:
3015 - Internal error
7003 - IP cannot be used
7006 - Edge IP not found content: application/json: schema: $ref: '#/components/schemas/ApiResult' components: schemas: ApiResultGetSsoToken: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} generated_token: type: string example: 344ebcaf34dff34 ApiResultListUsers: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} accounts: type: array items: $ref: '#/components/schemas/accounts' Login: type: object properties: login_id: type: string example: demo_account@incapsula.com email_verified: type: boolean example: true accounts: type: object properties: email: type: string example: example@imperva.com plan_id: type: string example: ent100 plan_name: type: string example: Enterprise 100 trial_end_date: type: string format: date-time account_id: type: integer format: int64 example: 10 John Account: type: string example: Jhon user_name: type: string example: Jhon logins: type: array items: $ref: '#/components/schemas/Login' log_level: type: string example: full support_level: type: string example: Standard support_all_tls_versions: type: boolean example: true wildcard_san_for_new_sites: type: string example: 'true' enum: - 'True' - 'False' - Default naked_domain_san_for_new_www_sites: type: boolean example: true ApiResultSubAccountStatus: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} sub_account: $ref: '#/components/schemas/SubAccountStatus' SubAccountStatus: type: object properties: sub_account_id: type: integer format: int64 example: 10 sub_account_name: type: string example: My Sub Account ref_id: type: string example: '432' logins: type: array items: $ref: '#/components/schemas/Login' log_level: type: string example: full support_level: type: string example: Standard ApiResult: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} ApiResultAccountStatus: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} account: $ref: '#/components/schemas/account' account: type: object properties: email: type: string example: example@imperva.com plan_id: type: string example: ent100 plan_name: type: string example: Enterprise 100 trial_end_date: type: string format: date-time account_id: type: integer format: int64 example: 10 John Account: type: string example: Jhon user_name: type: string example: Jhon logins: type: array items: $ref: '#/components/schemas/Login' log_level: type: string example: full support_level: type: string example: Standard support_all_tls_versions: type: boolean example: true wildcard_san_for_new_sites: type: string example: 'true' enum: - 'True' - 'False' - Default naked_domain_san_for_new_www_sites: type: boolean example: true AccountBandwidth: type: object properties: ' billingCycle': type: string example: Earlier billing cycle onDemandBandwidth: type: string example: 0bps alwaysOnBandwidth: type: string example: 7.7kbps AccountPlanStatus: type: object properties: accountId: type: integer format: int64 example: 12345 accountName: type: string example: demo_account@incapsula.com websiteProtection: type: array example: name: Website Protection planSectionRows: - name: Additional Sites purchased: '100' used: '2' - name: Load Balancing (old) purchased: '0' used: '0' - name: Additional Login Protect Users purchased: '5' used: '0' items: type: object properties: name: type: string planSectionRows: type: array items: $ref: '#/components/schemas/PlanSectionRow' infrastructureProtection: type: array example: name: Infrastructure Protection planSectionRows: - name: On Demand Bandwidth (Clean traffic) purchased: '0' used: '' - name: GRE Tunnel Pairs purchased: '0 ' used: '0' items: type: object properties: name: type: string planSectionRows: type: array items: $ref: '#/components/schemas/PlanSectionRow' dnsProtection: type: array example: name: DNS Protection planSectionRows: - name: Additional DNS Zones purchased: '0' used: '0' items: type: object properties: name: type: string planSectionRows: type: array items: $ref: '#/components/schemas/PlanSectionRow' additionalServices: type: array example: name: Additional Services planSectionRows: - name: Always On Bandwidth (Clean traffic) purchased: 10Mbps used: N/A - name: DDoS Protection purchased: None used: '' - name: Support Level purchased: Standard used: Standard - name: SIEM Integration purchased: '10' used: '0' - name: Web Attack Analytics purchased: '0' used: '' items: type: object properties: name: type: string planSectionRows: type: array items: $ref: '#/components/schemas/PlanSectionRow' ApiResultAccountSubscription: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} planStatus: $ref: '#/components/schemas/AccountPlanStatus' bandwidthHistory: type: array items: $ref: '#/components/schemas/AccountBandwidth' PlanSection: type: object properties: name: type: string planSectionRows: type: array items: $ref: '#/components/schemas/PlanSectionRow' PlanSectionRow: type: object properties: name: type: string purchased: type: string used: type: string ApiResultAddCacheRule: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} rule_id: type: integer format: int64 example: 10 SiteCacheRuleResponse: type: object example: HTTP_CACHE_FORCE_UNCACHEABLE: - id: '3746' name: rule1 action: HTTP_CACHE_FORCE_UNCACHEABLE filter: URL == "/admin" disabled: 'false' disabledByCacheMode: 'false' HTTP_CACHE_DIFFERENTIATE_BY_COOKIE: - id: '3749' name: rule3 action: HTTP_CACHE_DIFFERENTIATE_BY_COOKIE filter: CookieExists == "xGroup" differentiatedByValue: xGroup disabled: 'false' disabledByCacheMode: 'false' HTTP_CACHE_CREATE_TAG: - id: '3745' name: rule4 action: HTTP_CACHE_CREATE_TAG filter: User-Agent contains "Iphone" | User-Agent contains "Android" tag: mobile disabled: 'false' disabledByCacheMode: 'false' HTTP_CACHE_IGNORE_PARAMS: - id: '3751' name: rule7 action: HTTP_CACHE_IGNORE_PARAMS params: oid filter: ParamExists == "oid" disabled: 'false' disabledByCacheMode: 'false' - id: '3752' name: rule8 action: HTTP_CACHE_IGNORE_PARAMS params: xid filter: ParamExists == "xid" disabled: 'false' disabledByCacheMode: 'false' HTTP_CACHE_MAKE_STATIC: - id: '3744' name: rule9 action: HTTP_CACHE_MAKE_STATIC ttl: '1' ttlUnit: MINUTES filter: URL == "/admin" disabled: 'false' disabledByCacheMode: 'false' InfraStatsApiResponse: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} example: stats: - objectId: 607074 payload: - interval: 15000 startTime: 1509936300000 data: - 0 - 15 metric: pps pop: tko ipPrefix: 192.168.205.0/24 ipPrefixType: bgp traffic: passed - interval: 15000 startTime: 1509936300000 data: - 7968575 - 8484564 metric: bw pop: tko ipPrefix: 192.168.205.0/24 ipPrefixType: bgp traffic: passed res: 0 res_message: OK debug_info: {} ADRule: type: object properties: id: type: string name: type: string action: type: string example: Redirect createdAt: type: string format: date-time updatedBy: type: string example: example@imperva.com hits: type: integer format: int32 example: 3451 ADRuleSeries: type: object properties: id: type: string name: type: string action: type: string example: Redirect createdAt: type: string format: date-time updatedBy: type: string example: example@imperva.com hits: type: array example: - - 1478613600000 - 6 - - 1478617200000 - 3 items: type: object ApiResultSiteStats: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} visits_timeseries: type: array items: $ref: '#/components/schemas/VisitsItem' requests_geo_dist_summary: $ref: '#/components/schemas/RequestsGeo' visits_dist_summary: type: array items: $ref: '#/components/schemas/VisitsSummary' caching: $ref: '#/components/schemas/Caching' caching_timeseries: type: array items: $ref: '#/components/schemas/TimeSeriesItem' hits_timeseries: type: array items: $ref: '#/components/schemas/TimeSeriesItem' bandwidth_timeseries: type: array items: $ref: '#/components/schemas/TimeSeriesItem' threats: type: array items: $ref: '#/components/schemas/Threat' incap_rules: type: array items: $ref: '#/components/schemas/IncapRule' incap_rules_timeseries: type: array items: $ref: '#/components/schemas/IncapRuleSeries' delivery_rules: type: array items: $ref: '#/components/schemas/ADRule' delivery_rules_timeseries: type: array items: $ref: '#/components/schemas/ADRuleSeries' Caching: type: object properties: saved_requests: type: integer format: int64 example: 23984923 total_requests: type: integer format: int64 example: 48723648 saved_bytes: type: integer format: int64 example: 762394786 total_bytes: type: integer format: int64 example: 1098349834 IncapRule: type: object properties: id: type: string name: type: string action: type: string example: Require Javascript Support incidents: type: integer format: int32 example: 3451 createdAt: type: string format: date-time updatedBy: type: string example: example@imperva.com IncapRuleSeries: type: object properties: id: type: string name: type: string action: type: string example: Require Javascript Support createdAt: type: string format: date-time updatedBy: type: string example: example@imperva.com incidents: type: array example: - - 1478613600000 - 6 - - 1478617200000 - 3 items: type: object RequestsGeo: type: object properties: id: type: string name: type: string data: type: array example: '[[''Tokyo, JA'',24365435],[''Los Angeles, CA'',98762738]]' items: type: object Threat: type: object properties: id: type: string name: type: string incidents: type: integer format: int64 example: 12 status: type: string example: ok status_text_id: type: string example: api.threats.action.block_request status_text: type: string example: Block Request followup: type: string example: api.threats.followup.view followup_text: type: string example: View Incidents followup_url: type: string example: https://my.incapsula.com/sites/siteVisits?token=1123_103_13234435091_5d55197912387b94&timeFrame=last_7_days&extSiteId=123&threatFilters=badBot TimeSeriesItem: type: object properties: id: type: string name: type: string data: type: array example: - - 1344247200000 - 5 items: type: object VisitsItem: type: object properties: id: type: string name: type: string data: type: array example: - - 1344247200000 - 50 - - 1344247500000 - 40 items: type: object VisitsSummary: type: object properties: id: type: string name: type: string data: type: array example: '[[''np'',15],[''no'',778]]' items: type: array items: type: object AnalyticsTopTableApiResponse: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} stats: type: array items: $ref: '#/components/schemas/AnalyticsTopTableData' AnalyticsTopTableData: type: object properties: object: type: string example: 10.200.98.3 value: type: number format: double example: 334160 total: type: number format: double example: 1109938 AnalyticsTopGraphDataResponse: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} stats: type: array items: $ref: '#/components/schemas/Stats' Stats: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} objectid: type: string example: '200' time: type: string example: '1522761000000' payload: type: array items: $ref: '#/components/schemas/TopGraphPayloads' TopGraphPayloads: type: object properties: interval: type: string example: '15000' startTime: type: string format: date-time data: type: array example: - 5462 - 7563 items: type: object example: - 5462 - 7563 metric: type: string example: pps dataType: type: string example: ip item: type: string example: 10.13.0.1 traffic: type: string example: blocked AnalyticsHistogramApiResponse: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} stats: type: array example: PL_100: '366450640' PL_200: '305475960' PL_300: '0' PL_400: '0' PL_500: '0' PL_600: '0' PL_700: '0' PL_800: '0' PL_900: '0' PL_1000: '0' PL_1100: '0' PL_1200: '0' PL_1300: '0' PL_1400: '0' PL_1500: '0' items: type: object additionalProperties: type: object ActionItem: type: object properties: queryString: type: string example: ?jobSYapi_password\u003dXXXXX postData: type: string requestResult: type: string description: requestResult example: api.request_result.req_challenge_javascript isSecured: type: boolean example: false url: type: string example: www.google.com/ddos/ddos-mitigation-services httpStatus: type: integer format: int32 example: 200 responseTime: type: integer format: int64 example: 170 thinkTime: type: integer format: int64 example: 169 incidentId: type: string example: 3411008890000033213-29571073433152 threats: type: array items: $ref: '#/components/schemas/ThreatItem' ApiResultSessions: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} visits: type: array items: $ref: '#/components/schemas/SessionItem' SessionItem: type: object properties: id: type: string example: '133077760038625792' siteId: type: integer format: int64 example: 7 startTime: type: integer format: int64 example: 1361468485000 endTime: type: integer format: int64 example: 1361468486000 clientIPs: type: array items: type: object example: 12.13.14.15 country: uniqueItems: true type: array items: type: object example: Sweden countryCode: uniqueItems: true type: array items: type: object example: SE clientType: type: string example: Unclassified clientApplication: type: string example: Bot clientApplicationId: type: integer format: int64 example: 0 httpVersion: type: string example: '2.0' clientApplicationVersion: type: string example: '0' userAgent: type: string example: Mozilla/4.0 (compatible; MSIE 5.0; Windows 95; DigExt) os: type: string example: Windows osVersion: type: string example: Windows supportsCookies: type: boolean example: true supportsJavaScript: type: boolean example: true hits: type: integer format: int64 example: 1 pageViews: type: integer format: int64 example: 1 entryReferer: type: string example: http://lp.usafis.org/_Incapsula_Resource?CWUDNSAI=9_E1521557&incident_id=133077760038102423-139906691365201416&edet=12&cinfo=2ef678e2c753856785000000 entryPage: type: string example: www.incapsula.com/ddos/ddos-mitigation-services servedVia: type: array items: type: object example: Los Angeles, CA securitySummary: type: array example: api.threats.sql_injection: '2' api.threats.cross_site_scripting: '1' api.threats.illegal_resource_access: '3' api.threats.remote_file_inclusion: '2' api.threats.customRule: '3' api.threats.ddos=DDoS: '4' api.threats.backdoor: '2' api.threats.bot_access_control: '1' api.acl.blacklisted_countries: '1' api.acl.blacklisted_urls: '1' api.acl.blacklisted_ips: '1' items: type: object additionalProperties: type: object actions: type: array items: $ref: '#/components/schemas/ActionItem' ThreatItem: type: object properties: securityRule: type: string example: api.threats.illegal_resource_access alertLocation: type: string example: api.alert_location.alert_location_path attackCodes: uniqueItems: true type: array items: type: object example: 9070.0 securityRuleAction: type: string example: api.rule_action_type.rule_action_block description: threats ApiResultLCPublicKey: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} publicKeyId: type: integer format: int64 example: 1 InfraEventsApiResponse: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} events: type: array items: $ref: '#/components/schemas/InfraProtectEvent' InfraProtectEvent: type: object properties: eventTime: type: string format: date-time eventType: type: string example: DDOS_STOP_IP_RANGE enum: - GRE_TUNNEL_UP - GRE_TUNNEL_DOWN - ORIGIN_CONNECTION_GRE_UP - ORIGIN_CONNECTION_GRE_DOWN - ORIGIN_CONNECTION_ECX_UP - ORIGIN_CONNECTION_ECX_DOWN - ORIGIN_CONNECTION_CROSS_CONNECT_UP - ORIGIN_CONNECTION_CROSS_CONNECT_DOWN - IP_RANGE_ATTACK_START - IP_RANGE_ATTACK_STOP - DDOS_START_IP_RANGE - DDOS_STOP_IP_RANGE - DDOS_QUIET_TIME_IP_RANGE - EXPORTER_NO_DATA - EXPORTER_BAD_DATA - EXPORTER_GOOD_DATA - MONITORING_ATTACK - MONITORING_CRITICAL_ATTACK - PROTECTED_IP_STATUS_UP - PROTECTED_IP_STATUS_DOWN - PER_IP_DDOS_START_IP_RANGE - PER_IP_DDOS_STOP_IP_RANGE - IIP_ACCOUNT_SERVICE_SUSPENDED - IIP_ACCOUNT_SERVICE_UNSUSPENDED - INFRAPROTECT_NULL_ROUTE_STARTED - INFRAPROTECT_NULL_ROUTE_ESCALATED - INFRAPROTECT_NULL_ROUTE_ENDED bwTotal: type: integer format: int64 example: 9000 ppsTotal: type: integer format: int64 example: 90 bwPassed: type: integer format: int64 example: 200 ppsPassed: type: integer format: int64 example: 87 bwBlocked: type: integer format: int64 example: 8800 ppsBlocked: type: integer format: int64 example: 3 eventTarget: type: string example: IP_RANGE enum: - GRE_TUNNEL - IP_RANGE - EXPORTER - PROTECTED_IP - INCAPSULA_IP - NULL_ROUTE reportedByPop: type: string example: zrh ApiResultIncapsulaRanges: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} ipRanges: type: array items: type: object example: 199.83.128.0/21 ipv6Ranges: type: array items: type: object example: 2a02:e980::/29 ApiResultGetTexts: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} texts: type: array example: api.stats.visits_timeseries.human: Human visits api.stats.visits_timeseries.bot: Bot visits api.threats.followup.view: View Incidents items: type: object additionalProperties: type: object GeoInfo: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} countriesCodes: type: array example: BD: Bangladesh BE: Belgium items: type: object additionalProperties: type: object continentsCodes: type: array example: AF: Africa items: type: object additionalProperties: type: object ApiResultGetClappsInfo: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} clientApps: type: array example: '1': Firefox items: type: object additionalProperties: type: object clientAppTypes: type: array example: '1': Browser items: type: object additionalProperties: type: object APISealLocationItem: type: object properties: id: type: string name: type: string ApiResultSiteStatus: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} site_id: type: integer format: int64 example: 10 statusEnum: type: string example: pending-dns-changes enum: - pending-dns-changes - fully-configured - pending-select-approver - pending-certificate - unknown status: type: string example: pending-dns-changes domain: type: string example: admin@example.com account_id: type: integer format: int64 example: 1 acceleration_level: type: string example: advanced site_creation_date: type: integer format: int64 example: 1610396346000 ips: type: array items: type: object example: 1.2.3.4 dns: type: array items: $ref: '#/components/schemas/DnsInstructionItem' original_dns: type: array items: $ref: '#/components/schemas/DnsInstructionItem' warnings: type: array items: $ref: '#/components/schemas/SiteConfigurationWarning' active: type: string example: active enum: - active - bypass support_all_tls_versions: type: boolean example: true use_wildcard_san_instead_of_full_domain_san: type: boolean example: true add_naked_domain_san: type: boolean example: true set_site_cookies_without_domain: type: boolean example: true additionalErrors: type: array items: type: object example: 1001 display_name: type: string example: loginprotectapi1610396334653.incaptest.info security: type: array example: waf: rules: - id: api.threats.bot_access_control name: Bot Access Control block_bad_bots: true challenge_suspected_bots: true - id: api.threats.sql_injection name: SQL Injection action: api.threats.action.block_request action_text: Block Request - id: api.threats.cross_site_scripting name: Cross Site Scripting (XSS) exceptions: - values: - urls: - value: /gsddg pattern: EQUALS id: api.rule_exception_type.url name: URL id: 244711494 action: api.threats.action.alert action_text: Alert Only - id: api.threats.illegal_resource_access name: Illegal Resource Access action: api.threats.action.block_user action_text: Block User - id: api.threats.ddos name: DDoS activation_mode: api.threats.ddos.activation_mode.off activation_mode_text: 'Off' ddos_traffic_threshold: api.threats.ddos.ddos_trassic_threshold ddos_traffic_threshold_text: '750' - id: api.threats.backdoor name: Backdoor Protect action: api.threats.action.quarantine_url action_text: Auto-Quarantine - action: api.threats.action.block_ip action_text: Block IP id: api.threats.remote_file_inclusion name: Remote File Inclusion acls: rules: - ips: - 2.3.4.5 exceptions: - values: - id: api.rule_exception_type.url name: URL urls: - value: /home pattern: EQUALS id: 493271006 id: api.acl.blacklisted_ips name: Visitors from denylisted IPs items: type: object additionalProperties: type: object sealLocation: $ref: '#/components/schemas/APISealLocationItem' ssl: type: array example: origin_server: detected: 'true' detectionStatus: ok items: type: object additionalProperties: type: object siteDualFactorSettings: $ref: '#/components/schemas/SiteDualFactorSettings' login_protect: $ref: '#/components/schemas/LoginProtectApiResult' performance_configuration: $ref: '#/components/schemas/PerformanceConfigurationApiResult' extended_ddos: type: integer format: int32 example: 0 incap_rules: type: array items: $ref: '#/components/schemas/IncapRuleApiResult' DnsInstructionItem: type: object properties: dns_record_name: type: string example: loginprotectapi1610396334653.incaptest.info set_type_to: type: string example: CNAME enum: - CNAME - A - AAAA - MX - NS - TXT - Unkown - CAA set_data_to: type: array items: type: object example: 67eufzur3g.dev.impervadns.net IncapRuleApiResult: type: object properties: id: type: integer format: int64 example: 123 name: type: string example: Block Click Worms action: type: string example: api.rule_action_type.rule_action_block rule: type: string example: ClientIP == 1.2.3.4 creation_date: type: integer format: int64 updated_by: type: string example: John updated_at: type: integer format: int64 example: 1611228121241 comment: type: string example: rule comment LoginProtectApiResult: type: object properties: enabled: type: boolean example: true specific_users_list: type: array items: $ref: '#/components/schemas/specific_users_list' send_lp_notifications: type: boolean example: true allow_all_users: type: boolean example: true authentication_methods: uniqueItems: true type: array items: type: object example: email urls: type: array items: type: object example: /userlist url_patterns: type: array items: type: object example: CONTAINS PerformanceConfigurationApiResult: type: object properties: advanced_caching_rules: type: array example: never_cache_resources: - pattern: SUFFIX url: /test.html always_cache_resources: - pattern: NOT_EQUALS url: /index.html ttl: '5' ttlUnits: SECONDS - pattern: EQUALS url: /home.html ttl: '6' ttlUnits: DAYS items: type: object additionalProperties: type: object acceleration_level: type: string example: advanced async_validation: type: boolean example: true minify_javascript: type: boolean example: true minify_css: type: boolean example: true minify_static_html: type: boolean example: true compress_jpeg: type: boolean example: true compress_jepg: type: boolean example: true progressive_image_rendering: type: boolean example: true aggressive_compression: type: boolean example: true compress_png: type: boolean example: true on_the_fly_compression: type: boolean example: true tcp_pre_pooling: type: boolean example: true comply_no_cache: type: boolean example: true comply_vary: type: boolean example: true use_shortest_caching: type: boolean example: true perfer_last_modified: type: boolean example: true prefer_last_modified: type: boolean example: true disable_client_side_caching: type: boolean example: true cache300x: type: boolean example: true cache_headers: uniqueItems: true type: array items: type: object SiteConfigurationWarning: type: object properties: type: type: string example: CNAME enum: - CNAME - A - AAAA - MX - NS - TXT - Unkown - CAA set_data_to: type: array items: type: object example: 67eufzur3g.dev.impervadns.net SiteDualFactorSettings: type: object properties: specificUsers: type: array items: type: string example: lpuser1_api1610396342408@incaptest.info enabled: type: boolean example: false customAreas: type: array items: $ref: '#/components/schemas/customAreas' customAreasExceptions: type: array items: $ref: '#/components/schemas/customAreasExceptions' allowAllUsers: type: boolean example: true shouldSuggestApplicatons: type: boolean example: true allowedMedia: uniqueItems: true type: array items: type: string example: sms enum: - ga - sms - email shouldSendLoginNotifications: type: boolean example: true application: type: boolean writeOnly: true version: type: integer format: int32 customAreas: type: object properties: pattern: type: string example: CONTAINS enum: - EQUALS - NOT_EQUALS - NOT_CONTAINS - PREFIX - SUFFIX - NOT_PREFIX - NOT_SUFFIX - CONTAINS url: type: string example: /userlist customAreasExceptions: type: object properties: pattern: type: string example: CONTAINS enum: - EQUALS - NOT_EQUALS - NOT_CONTAINS - PREFIX - SUFFIX - NOT_PREFIX - NOT_SUFFIX - CONTAINS url: type: string example: /userlist specific_users_list: type: object properties: email: type: string description: email example: John@example.com name: type: string description: name example: John Doe status: type: string description: status example: INVITATION_SENT LoginProtectUsersApiResults: type: object properties: users: type: array items: $ref: '#/components/schemas/LpExtendedUser' LpExtendedUser: type: object properties: email: type: string description: email example: John@example.com name: type: string description: name example: John Doe status: type: string description: status example: INVITATION_SENT phone: type: string description: phone example: 1-8662507658 creation_date: type: string description: creation_date format: date-time DataCenterResponse: type: object properties: datacenter_id: type: integer format: int32 example: 484377 status: type: string example: ok res: type: string example: '0' ServerOperationResponse: type: object properties: server_id: type: string example: '2' status: type: string example: ok res: type: string example: '0' ListDataCenterResponse: type: object example: - isActive: true id: '54313' enabled: 'false' isStandBy: 'false' servers: - id: '1034487' enabled: 'true' address: 69.61.27.182 isStandby: 'true' contentOnly: 'true' PopRttResponse: type: object properties: id: type: string example: ord name: type: string example: Chicago, IL region: type: string example: US Central rtt: type: integer format: int32 example: 8 RecommendedPopsApiResult: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} pops: type: array items: $ref: '#/components/schemas/PopRttResponse' reason: type: string example: N/A ApiResultGetCacheMode: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} cache_mode: type: string example: static_and_dynamic ApiResultGetResponseHeaderSettings: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} enabled: type: boolean example: true mode: type: string example: CUSTOM custom_headers: uniqueItems: true type: array items: type: string example: Header1 ApiResultGetTagResponseHeader: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} header: type: string example: h1 GetCache404SettingsApiResult: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} enabled: type: boolean example: true time: type: integer format: int32 example: 10 time_unit: type: string example: HOURS GetPopLevelCacheSettingsApiResult: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} enabled: type: boolean example: true ApiResultGetResourceMapSize: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} resource_map_size: type: integer format: int32 example: 34000 ApiResultGetCacheSizeLimitLargeMem: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} cache_size_limit_large_mem: type: integer format: int64 example: 500 unit: type: string example: MB ApiResultGetMaxRespSize: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} max_resp_size: type: integer format: int32 example: 20971520 unit: type: string example: BYTES ApiResultGetSecureResources: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} secured_resources_mode: type: string example: do_not_cache (i.e. Do not cache HTTPS resources) GetStaleContentApiResult: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} enabled: type: boolean example: true mode: type: string example: ADAPTIVE time: type: integer format: int32 example: 10 unit: type: string example: HOURS GetAdvancedCachingSettingsApiResult: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} value: type: boolean example: true ApiResultGetSiteXrayLink: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} url: type: string example: https:// IsCacheShieldEnabledApiResult: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} enabled: type: boolean example: true ApiResultGetRewritePorts: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} port: $ref: '#/components/schemas/RewritePort' ssl_port: $ref: '#/components/schemas/RewritePort' RewritePort: type: object properties: from: type: string to: type: string ApiResultListSites: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} ApiResultSiteStatus: type: array items: $ref: '#/components/schemas/ApiResultSiteStatus' ApiResultDomainEmails: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} domain_emails: type: array items: type: object example: admin.example.com ApiResultSetSupportDeprecatedTLSForSite: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} support_all_tls_versions: type: boolean example: true new_A_record: type: string example: 1.2.3.4 additional_instructions: type: string example: After the site is moved, update the site’s 'A' records according to the information in Websites General Settings. ApiResultSetDataRegion: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} region: type: string example: US ApiResultReport: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} format: type: string example: pdf enum: - html - xml - amf - pdf - flash - json - mail - csv - statistics - syslog report: type: string example: JVBERi0xLjUNCiXvv73vv73vv73vv70NCjEgMCBvYmoNCjw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUi9MYW5nKGVuLVVT ... ApiResultHtmlInjections: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} html_injections: type: array items: $ref: '#/components/schemas/HtmlInjectionItem' HtmlInjectionItem: type: object properties: url: type: string example: / url_pattern: type: string example: prefix enum: - EQUALS - NOT_EQUALS - NOT_CONTAINS - PREFIX - SUFFIX - NOT_PREFIX - NOT_SUFFIX - CONTAINS location: type: string example: head content: type: string example: Some content CaaComplianceCheckResult: type: object properties: res: type: integer format: int32 res_message: type: string non_compliant_sans: type: array items: type: object example: '*.caa.incaptest.co' ApiResultMoveSite: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} status: type: string writeOnly: true enum: - MOVED - PENDING_CA_APPROVAL - FAILED SetPriorityResponse: type: object properties: status: type: string example: ok res: type: string example: '0' CustomRuleResponse: type: object properties: rule_id: type: integer format: int64 example: 43573 status: type: string example: ok res: type: integer format: int32 example: 0 DeleteCustomRuleResponse: type: object properties: status: type: string example: ok res: type: integer format: int32 example: 0 ListCustomRulesResponse: type: object properties: incap_rules: type: array example: All: - id: '3660' last_7_days_requests_count: '0' name: Ortal action: RULE_ACTION_ALERT filter: '' items: type: object additionalProperties: type: object delivery_rules: type: array example: Redirect: - to: /home.php id: '3648' priority: '1' last_7_days_requests_count: '0' name: Test new action: RULE_ACTION_REWRITE_URL from: '*/home.html' filter: ASN == 1 Forward: - id: '3628' priority: '2' last_7_days_requests_count: '0' name: move to rewrite dc_id: '54313' action: RULE_ACTION_FORWARD_TO_DC filter: '' items: type: object additionalProperties: type: object rate_rules: type: array example: Rates: - id: '4723' enabled: 'true' interval: '120' name: Test Rate IP context: IP action: RULE_ACTION_RATE internal_name: test-rate-ip filter: ASN == 2 items: type: object additionalProperties: type: object ApiResultTestAlert: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} ip_prefix: type: string example: 100.1.2.0/24 status: type: string example: DDoS start notification sent successfully ApiResultTestAlertConnectionStatus: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} ip_prefix: type: string example: 100.1.2.0/24 status: type: string example: DDoS start notification sent successfully connection_name: type: string example: CONNECTION_NAME ApiResultTestAlertProtectedIPStatus: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} ip_prefix: type: string example: 100.1.2.0/24 status: type: string example: DDoS start notification sent successfully ip: type: string example: 1.2.3.4 ApiResultTestAlertExporterStatus: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} ip_prefix: type: string example: 100.1.2.0/24 status: type: string example: DDoS start notification sent successfully ApiResultInfraProtectSipIp: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} edge_ip: type: string example: 172.17.14.1 origin_ip: type: string example: 1.2.3.4 ApiResultInfraProtectSipCname: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} edge_ip: type: string example: 172.17.14.1 cname: type: string example: imperva.test.com ApiResultInfraProtectSipDnsWithIp: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} edge_ip: type: string example: 172.17.14.1 resolved_ips: uniqueItems: true type: array items: type: string example: 157.166.226.25 origin_ip: type: string example: 157.166.249.10 ApiResultInfraProtectSipDnsWithCname: type: object properties: res: type: integer description: res - contains specific error code format: int32 example: 0 res_message: type: string example: OK debug_info: type: array items: type: object additionalProperties: type: object example: {} example: {} edge_ip: type: string example: 172.17.14.1 resolved_cnames: uniqueItems: true type: array items: type: string example: imperva.test.com cname: type: string example: imperva.test.com securitySchemes: api_id: type: apiKey name: x-API-Id in: header api_key: type: apiKey name: x-API-Key in: header