Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Imperva Site Management API

Add, remove, and update sites.

Imperva Site Management API is one of 15 APIs that Imperva publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Site Management. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 77 operations across 77 paths, and defines 47 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against a single base URL, https://my.imperva.com.

77 operations 77 paths 47 schemas 77 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://api.imperva.com
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

Imperva Site Management API declares 2 security schemes for authenticating requests. An API key is passed in the header as x-API-Id (api_id). An API key is passed in the header as x-API-Key (api_key). By default, every request must be authenticated.

Paths & Operations 77

Across 77 paths, the API surfaces 77 operations — 77 POST. Each is listed below with its method, path, parameters, and response codes.

Site Management 77

Add, remove, and update sites.

POST
/api/prov/v1/sites/performance/caching-rules/add
Add a cache rule
addCacheRule 11 params → 200
POST
/api/prov/v1/sites/performance/caching-rules/delete
Delete a cache rule
deleteCacheRule 2 params → 200
POST
/api/prov/v1/sites/performance/caching-rules/enable
Enable or disable cache rule
enableDisableCacheRule 3 params → 200
POST
/api/prov/v1/sites/performance/caching-rules/list
List cache rules for a given site
listCacheRules 3 params → 200
POST
/api/prov/v1/sites/performance/caching-rules/edit
Edit a cache rule
editCacheRule 12 params → 200
POST
/api/prov/v1/sites/dataCenters/add
Add data center
addDataCenter 6 params → 200
POST
/api/prov/v1/sites/dataCenters/edit
Edit site
editDataCenter 5 params → 200
POST
/api/prov/v1/sites/dataCenters/resume
Resume traffic to your active data centers
resumeTrafficToActiveDCs 1 param → 200
POST
/api/prov/v1/sites/dataCenters/delete
delete site
deleteDataCenter 1 param → 200
POST
/api/prov/v1/sites/dataCenters/servers/add
Add datacenter
addDCServer 4 params → 200
POST
/api/prov/v1/sites/dataCenters/servers/delete
Delete datacenter
deleteDCServer 1 param → 200
POST
/api/prov/v1/sites/dataCenters/servers/edit
Edit datacenter
editDCServer 4 params → 200
POST
/api/prov/v1/sites/dataCenters/list
List site's data centers
listDataCenters 1 param → 200
POST
/api/prov/v1/sites/datacenter/origin-pop/modify
Set Data Center Origin PoP
setDataCenterOriginPoP 2 params → 200
POST
/api/prov/v1/sites/datacenter/origin-pop/recommend
Get Data Center Recommended Origin PoPs
getRecommendedDataCenterOriginPoPs 1 param → 200
POST
/api/prov/v1/sites/performance/cache-mode
Modify Caching Mode
setCachingMode 4 params → 200
POST
/api/prov/v1/sites/performance/cache-mode/get
Get Caching Mode
getCachingMode 1 param → 200
POST
/api/prov/v1/sites/performance/purge
Purge Resources
modifyPurgeSettings 4 params → 200
POST
/api/prov/v1/sites/cache/purge
Purge Site Cache
purgeSiteCache 3 params → 200
POST
/api/prov/v1/sites/performance/response-headers
Modify Cached Response Headers
modifyResponseHeaderSettings 3 params → 200
POST
/api/prov/v1/sites/performance/response-headers/get
Get Cached Response Headers
getResponseHeaderSettings 1 param → 200
POST
/api/prov/v1/sites/performance/tag-response
Tag the Response According to the Value of a Header
modifyTagResponseHeader 2 params → 200
POST
/api/prov/v1/sites/performance/tag-response/get
Get Header to Tag Responses By
getTagResponseHeader 1 param → 200
POST
/api/prov/v1/sites/performance/cache404/modify
Modify Cache 404 Settings
modifyCache404Settings 4 params → 200
POST
/api/prov/v1/sites/performance/cache404
Get Cache 404 Settings
getCache404Settings 1 param → 200
POST
/api/prov/v1/sites/performance/pop-level-cache/modify
Modify PoP Level Cache
modifyPopLevelCache 2 params → 200
POST
/api/prov/v1/sites/performance/pop-level-cache
Get PoP Level Cache
getPopLevelCache 1 param → 200
POST
/api/prov/v1/sites/performance/resource-map-size/modify
Set Resource Map Size
setResourceMapSize 2 params → 200
POST
/api/prov/v1/sites/performance/resource-map-size
Get Resource Map Size
getResourceMapSize 1 param → 200
POST
/api/prov/v1/sites/performance/cache-size-limit-large-mem/modify
Set Total Cache Size
setCacheSizeLimitLargeMem 3 params → 200
POST
/api/prov/v1/sites/performance/cache-size-limit-large-mem
Get Total Cache Size
getCacheSizeLimitLargeMem 1 param → 200
POST
/api/prov/v1/sites/performance/max-resp-size/modify
Set Response Max Size
setMaxRespSize 3 params → 200
POST
/api/prov/v1/sites/performance/max-resp-size
Get Response Max Size
getMaxRespSize 1 param → 200
POST
/api/prov/v1/sites/performance/secure-resources
Modify Secure Resources Mode
setSecureResourcesMode 2 params → 200
POST
/api/prov/v1/sites/performance/secure-resources/get
Get Secure Resources Mode
getSecureResourcesMode 1 param → 200
POST
/api/prov/v1/sites/performance/stale-content
Modify Stale Content Settings
modifyStaleContent 5 params → 200
POST
/api/prov/v1/sites/performance/stale-content/get
Get Stale Content Settings
getStaleContent 1 param → 200
POST
/api/prov/v1/sites/performance/advanced
Advanced Caching Settings
modifyAdvancedCachingSettings 3 params → 200
POST
/api/prov/v1/sites/performance/advanced/get
Get Advanced Caching Settings
getAdvancedCachingSettings 2 params → 200
POST
/api/prov/v1/sites/xray/get-link
Get XRay Access Link
getXrayLink 1 param → 200
POST
/api/prov/v1/sites/performance/cache-shield/enable
Enable Cache Shield
enableCacheShield 2 params → 200
POST
/api/prov/v1/sites/performance/cache-shield
Is Cache Shield Enabled
isCacheShieldEnabled 1 param → 200
POST
/api/prov/v1/sites/performance/rewrite-port/modify
Modify Rewrite Port
modifyRewritePorts 5 params → 200
POST
/api/prov/v1/sites/performance/rewrite-port
Get Rewrite Port
getRewritePorts 1 param → 200
POST
/api/prov/v1/sites/performance/error-page/modify
Modify Error Page
modifySiteErrorPageTemplate 2 params → 200
POST
/api/prov/v1/sites/performance/error-page
Get Error Page
getSiteErrorPageTemplate 1 param → 200
POST
/api/prov/v1/sites/status
Get Site Status
siteStatus 2 params → 200
POST
/api/prov/v1/sites/list
List Sites
listSites 3 params → 200
POST
/api/prov/v1/domain/emails
Get Domain Approver E-mail Addresses
domainEmails 1 param → 200
POST
/api/prov/v1/sites/setlog
Modify Site Logs Level
modifySiteLogLevel 3 params → 200
POST
/api/prov/v1/sites/tls
Set support for all TLS versions
modifySiteSupportDeprecatedTLS 2 params → 200
POST
/api/prov/v1/sites/configure
Modify Site Configuration
modifySiteConfiguration 3 params → 200
POST
/api/prov/v1/sites/delete
Delete Site
deleteSite 1 param → 200
POST
/api/prov/v1/sites/add
Add a Site
addSite 10 params → 200
POST
/api/prov/v1/sites/configure/acl
Modify Site Access Control List (ACL) Configuration
modifySiteAclConfiguration 7 params → 200
POST
/api/prov/v1/sites/data-privacy/show
Get Site Data Storage Region
getDataRegion 1 param → 200
POST
/api/prov/v1/sites/configure/allowlist
Modify Allow Lists Configuration
modifySiteAllowListsConfiguration 13 params → 200
POST
/api/prov/v1/sites/configure/security
Modify Site Security Configuration
modifySiteSecurityConfiguration 8 params → 200
POST
/api/prov/v1/sites/report
Get Site Report
getSiteReport 6 params → 200
POST
/api/prov/v1/sites/hostname/purge
Purge Hostname from Cache
purgeHostname 1 param → 200
POST
/api/prov/v1/sites/htmlinjections
Get HTML Injection Rules
getHtmlInjectionRules 1 param → 200
POST
/api/prov/v1/sites/configure/htmlInjections
Add, Replace or Remove a HTML Injection Rule
setHtmlInjectionRule 6 params → 200
POST
/api/prov/v1/sites/customCertificate/upload
Upload Custom Certificate
uploadCustomCertificate 4 params → 200
POST
/api/prov/v1/sites/customCertificate/remove
Remove Custom Certificate
removeCustomCertificate 1 param → 200
POST
/api/prov/v1/sites/customCertificate/csr
Create New CSR
createNewCSR 7 params → 200
POST
/api/prov/v1/sites/data-privacy/region-change
Set Site Data Storage Region
setDataRegion 2 params → 200
POST
/api/prov/v1/sites/data-privacy/show-override-by-geo
List Available PoPs for Denylist/Allowlist
getOverrideSiteRegionsByGeo → 200
POST
/api/prov/v1/sites/data-privacy/override-by-geo
Set Site Regions by Origin Geolocation
setOverrideSiteRegionsByGeo 2 params → 200
POST
/api/prov/v1/caa/check-compliance
Check CAA compliance
checkCAACompliance 1 param → 200
POST
/api/prov/v1/sites/moveSite
Move site
moveSite 2 params → 200
POST
/api/prov/v1/sites/incapRules/priority/set
Set Rule Priority
setPriority 2 params → 200
POST
/api/prov/v1/sites/incapRules/edit
Edit Rule
editCustomRule 18 params → 200
POST
/api/prov/v1/sites/incapRules/add
Add Rule
addCustomRule 18 params → 200
POST
/api/prov/v1/sites/incapRules/enableDisable
Enable or Disable Rule
enableDisableCustomRule 2 params → 200
POST
/api/prov/v1/sites/incapRules/delete
Delete Data Center
deleteCustomRule 1 param → 200
POST
/api/prov/v1/sites/incapRules/list
List Rules
listCustomRules 5 params → 200
POST
/api/prov/v1/sites/incapRules/account/list
List Account Rules
listAccountCustomRules 3 params → 200

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are ApiResultSiteStatus (29 properties), PerformanceConfigurationApiResult (21 properties), SiteDualFactorSettings (10 properties), IncapRuleApiResult (8 properties). Each schema is shown below with its type and property counts.

ApiResultGetResponseHeaderSettings
object
6 properties
PerformanceConfigurationApiResult
object
21 properties
ListCustomRulesResponse
object
3 properties
ApiResult
object
3 properties
DnsInstructionItem
object
3 properties
specific_users_list
object
3 properties
ApiResultReport
object
5 properties
IncapRuleApiResult
object
8 properties
ApiResultAddCacheRule
object
4 properties
GetPopLevelCacheSettingsApiResult
object
4 properties
ApiResultHtmlInjections
object
4 properties
CaaComplianceCheckResult
object
3 properties
RewritePort
object
2 properties
HtmlInjectionItem
object
4 properties
ApiResultGetCacheMode
object
4 properties
ApiResultDomainEmails
object
4 properties
SiteConfigurationWarning
object
2 properties
ApiResultGetRewritePorts
object
5 properties
IsCacheShieldEnabledApiResult
object
4 properties
customAreasExceptions
object
2 properties
ServerOperationResponse
object
3 properties
ApiResultGetSiteXrayLink
object
4 properties
ApiResultGetSecureResources
object
4 properties
SetPriorityResponse
object
2 properties
SiteCacheRuleResponse
object
LoginProtectApiResult
object
7 properties
RecommendedPopsApiResult
object
5 properties
PopRttResponse
object
4 properties
ApiResultGetTagResponseHeader
object
4 properties
ListDataCenterResponse
object
DeleteCustomRuleResponse
object
2 properties
customAreas
object
2 properties
ApiResultMoveSite
object
4 properties
ApiResultSiteStatus
object
29 properties
ApiResultGetResourceMapSize
object
4 properties
CustomRuleResponse
object
3 properties
GetAdvancedCachingSettingsApiResult
object
4 properties
ApiResultGetCacheSizeLimitLargeMem
object
5 properties
GetCache404SettingsApiResult
object
6 properties
ApiResultGetMaxRespSize
object
5 properties
DataCenterResponse
object
3 properties
ApiResultSetDataRegion
object
4 properties
ApiResultListSites
object
4 properties
ApiResultSetSupportDeprecatedTLSForSite
object
6 properties
SiteDualFactorSettings
object
10 properties
APISealLocationItem
object
2 properties
GetStaleContentApiResult
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

imperva-site-management-api-openapi.yml Raw ↑

Other APIs Imperva publishes across the network.

Imperva API Security
Imperva Data Security Fabric API
Imperva Account Management API
Imperva Administration API
Imperva Auth API
Imperva Conf API
Imperva DDoS for Networks Test Alerts API
Imperva DDoS Protection for Individual IPs API
Imperva Experimental API
Imperva Integrations API
Imperva Login Protect API
Imperva Management API