{
  "opencollection": "1.0.0",
  "info": {
    "name": "Akamai: Application Security Activation history Hostnames API",
    "version": "v1"
  },
  "items": [
    {
      "info": {
        "name": "Hostnames",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Akamai API Security List Hostname Overlaps",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/appsec/v1/configs/:configId/versions/:versionNumber/hostname-coverage/overlapping",
            "params": [
              {
                "name": "configId",
                "value": "{{configId}}",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "{{versionNumber}}",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "hostname",
                "value": "{{hostname}}",
                "type": "query",
                "description": "Get results by hostname."
              },
              {
                "name": "accountSwitchKey",
                "value": "{{accountSwitchKey}}",
                "type": "query",
                "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys)."
              }
            ]
          },
          "docs": "List the configuration versions that contain a hostname also included in the current configuration version. _Products:_ Kona Site Defender, App & API Protector with the Advanced Security module."
        },
        {
          "info": {
            "name": "Akamai API Security List Selected Hostnames for a Security Policy",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/appsec/v1/configs/:configId/versions/:versionNumber/security-policies/:policyId/selected-hostnames",
            "params": [
              {
                "name": "configId",
                "value": "{{configId}}",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "{{versionNumber}}",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "policyId",
                "value": "{{policyId}}",
                "type": "path",
                "description": "A unique identifier for a security policy."
              },
              {
                "name": "accountSwitchKey",
                "value": "{{accountSwitchKey}}",
                "type": "query",
                "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys)."
              }
            ]
          },
          "docs": "List the hostnames that the configuration version selects as candidates of protected hostnames, which you can use in match targets. _Products:_ Web Application Protector, App & API Protector."
        },
        {
          "info": {
            "name": "Akamai API Security Modify Selected Hostnames for a Security Policy",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{hostname}/appsec/v1/configs/:configId/versions/:versionNumber/security-policies/:policyId/selected-hostnames",
            "params": [
              {
                "name": "configId",
                "value": "{{configId}}",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "{{versionNumber}}",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "policyId",
                "value": "{{policyId}}",
                "type": "path",
                "description": "A unique identifier for a security policy."
              },
              {
                "name": "accountSwitchKey",
                "value": "{{accountSwitchKey}}",
                "type": "query",
                "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys)."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update the list of selected hostnames for a configuration. You can add an individual hostname to your selected hostnames list without passing the entire list plus the new hostname in this PUT object. Previously, you needed to pass every hostname in the PUT object or any hostnames not included would be deleted from the list. _Products:_ Web Application Protector, App & API Protector."
        },
        {
          "info": {
            "name": "Akamai API Security List Selectable Hostnames",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/appsec/v1/configs/:configId/versions/:versionNumber/selectable-hostnames",
            "params": [
              {
                "name": "configId",
                "value": "{{configId}}",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "{{versionNumber}}",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "{{accountSwitchKey}}",
                "type": "query",
                "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys)."
              }
            ]
          },
          "docs": "List the hostnames that a given configuration version has the ability to protect. Hostnames may show as error hosts when they aren't currently available. For example, when a contract expires. _Products:_ All."
        },
        {
          "info": {
            "name": "Akamai API Security List Selected Hostnames",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/appsec/v1/configs/:configId/versions/:versionNumber/selected-hostnames",
            "params": [
              {
                "name": "configId",
                "value": "{{configId}}",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "{{versionNumber}}",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "{{accountSwitchKey}}",
                "type": "query",
                "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys)."
              }
            ]
          },
          "docs": "List the hostnames that the configuration version selects as candidates of protected hostnames, which you can use in match targets. _Products:_ All."
        },
        {
          "info": {
            "name": "Akamai API Security Modify Selected Hostnames",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{hostname}/appsec/v1/configs/:configId/versions/:versionNumber/selected-hostnames",
            "params": [
              {
                "name": "configId",
                "value": "{{configId}}",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "{{versionNumber}}",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "{{accountSwitchKey}}",
                "type": "query",
                "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys)."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update the list of selected hostnames for a configuration version. Now you can add an individual hostname to your selected hostnames list without passing the entire list plus the new hostname in this PUT object. Previously, you needed to pass every hostname in the PUT object or any hostnames not included would be deleted from the list. _Products:_ All."
        }
      ]
    }
  ],
  "bundled": true
}