{
  "opencollection": "1.0.0",
  "info": {
    "name": "Kong Enterprise Admin ACLs API Specification API",
    "version": "3.14.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Kong-Admin-Token",
      "value": "{{Kong-Admin-Token}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "API Specification",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List API Specifications",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/specifications",
            "params": [
              {
                "name": "apiId",
                "value": "",
                "type": "path",
                "description": "The UUID API identifier"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "The maximum number of items to include per page. The last page of a collection may include fewer items."
              },
              {
                "name": "page[number]",
                "value": "",
                "type": "query",
                "description": "Determines which page of the entities to retrieve."
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "Filters API Specs in the response."
              }
            ]
          },
          "docs": "Returns a list of specifications for an API. The specification can be of type OpenAPI or AsyncAPI.\n**Note:** You can only have one specification for an API. This endpoint is deprecated and will be removed: use /versions instead.\n"
        },
        {
          "info": {
            "name": "Create API Specification",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/specifications",
            "params": [
              {
                "name": "apiId",
                "value": "",
                "type": "path",
                "description": "The UUID API identifier"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a specification (OpenAPI or AsyncAPI) for an API.\n**Note:** You can only have one specification for an API. This endpoint is deprecated and will be removed: use /versions instead.\n"
        },
        {
          "info": {
            "name": "Get API Specification",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/specifications/:specId",
            "params": [
              {
                "name": "apiId",
                "value": "",
                "type": "path",
                "description": "The UUID API identifier"
              },
              {
                "name": "specId",
                "value": "",
                "type": "path",
                "description": "The API specification identifier"
              }
            ]
          },
          "docs": "Fetches the specification (OpenAPI or AsyncAPI) of an API.\n**Note:** This endpoint is deprecated and will be removed: use /versions instead.\n"
        },
        {
          "info": {
            "name": "Update API Specification",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/specifications/:specId",
            "params": [
              {
                "name": "apiId",
                "value": "",
                "type": "path",
                "description": "The UUID API identifier"
              },
              {
                "name": "specId",
                "value": "",
                "type": "path",
                "description": "The API specification identifier"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the specification (OpenAPI or AsyncAPI) of an API.\n**Note:** This endpoint is deprecated and will be removed: use /versions instead.\n"
        },
        {
          "info": {
            "name": "Delete API Specification",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/specifications/:specId",
            "params": [
              {
                "name": "apiId",
                "value": "",
                "type": "path",
                "description": "The UUID API identifier"
              },
              {
                "name": "specId",
                "value": "",
                "type": "path",
                "description": "The API specification identifier"
              }
            ]
          },
          "docs": "Deletes the specification (OpenAPI or AsyncAPI) of an API.\n**Note:** This endpoint is deprecated and will be removed: use /versions instead.\n"
        },
        {
          "info": {
            "name": "Validate API Specification",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "{protocol}://{hostname}:{port}{path}/v3/apis/validate-specification",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Validates the content and type (OpenAPI or AsyncAPI) of a potential API specification without associating it with a specific API."
        }
      ]
    }
  ],
  "bundled": true
}