{
  "opencollection": "1.0.0",
  "info": {
    "name": "Akamai: API Endpoint Definition Access tokens General configuration settings API",
    "version": "2"
  },
  "items": [
    {
      "info": {
        "name": "General configuration settings",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List configurations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/api-definitions/v2/configs",
            "params": [
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Lists available security configurations."
        },
        {
          "info": {
            "name": "Create a configuration",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{hostname}/api-definitions/v2/configs",
            "params": [
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Create a new WAP or KSD security configuration. KSD security configurations start out empty, and WAP configurations are created with preset values. The contract you pass in the request body determines which product you use.  You can edit the default settings included in the WAP configuration, but you'll need to run additional operations in this API to select specific protections for KSD. Your KSD configuration needs match targets and protection settings before you activate."
        },
        {
          "info": {
            "name": "Get a security configuration",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "includeHostnames",
                "value": "",
                "type": "query",
                "description": "If `true`, include the list of hostnames protected by this security configuration in the production network.  If `false`, exclude the list of hostnames protected by this security configuration in the production network."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Retrieves the configuration details."
        },
        {
          "info": {
            "name": "Rename a security configuration",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Update the name of your security configuration."
        },
        {
          "info": {
            "name": "Delete a configuration",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Deletes the specified security configuration."
        },
        {
          "info": {
            "name": "List configuration versions",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId/versions",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The index of the result page. If the value is `-1`, then pagination is ignored.  The default value is `1`."
              },
              {
                "name": "pageSize",
                "value": "",
                "type": "query",
                "description": "The number of items on each result page. The default value is `25`."
              },
              {
                "name": "detail",
                "value": "",
                "type": "query",
                "description": "When `true`, the results contain detailed information on versions. With the default `false`, the results contain summary information on versions."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Lists available versions for the specified security configuration, with results optionally paginated."
        },
        {
          "info": {
            "name": "Clone a configuration version",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId/versions",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Creates a new version of the specified security configuration."
        },
        {
          "info": {
            "name": "Get configuration version details",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId/versions/:versionNumber",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Returns basic details about a configuration version. To get a more extensive object with detailed information about a version's security policies, rate policies, rules, and other additional settings, run the [Export a configuration version](https://techdocs.akamai.com/application-security/reference/get-export-config-version) operation."
        },
        {
          "info": {
            "name": "Delete a configuration version",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId/versions/:versionNumber",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Delete the specified configuration version. You can't delete a version that's actively in use."
        },
        {
          "info": {
            "name": "Get the version notes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId/versions/:versionNumber/version-notes",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Get the most recent version notes for a configuration."
        },
        {
          "info": {
            "name": "Modify version notes",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{hostname}/api-definitions/v2/configs/:configId/versions/:versionNumber/version-notes",
            "params": [
              {
                "name": "configId",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each configuration."
              },
              {
                "name": "versionNumber",
                "value": "",
                "type": "path",
                "description": "A unique identifier for each version of a configuration."
              },
              {
                "name": "accountSwitchKey",
                "value": "",
                "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": "__All products__ Update the most recent version notes for a configuration."
        }
      ]
    }
  ],
  "bundled": true
}