{ "opencollection": "1.0.0", "info": { "name": "Kong Enterprise Admin ACLs API Version API", "version": "3.14.0" }, "request": { "auth": { "type": "apikey", "key": "Kong-Admin-Token", "value": "{{Kong-Admin-Token}}", "placement": "header" } }, "items": [ { "info": { "name": "API Version", "type": "folder" }, "items": [ { "info": { "name": "List API Versions", "type": "http" }, "http": { "method": "GET", "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/versions", "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 Version in the response." }, { "name": "sort", "value": "", "type": "query", "description": "Sorts a collection of API versions. Supported sort attributes are:\n - created_at\n" } ] }, "docs": "Returns a list of versions for an API. The version can be of type OpenAPI or AsyncAPI.\n**Note:** You can only have one version for an API.\n" }, { "info": { "name": "Create API Version", "type": "http" }, "http": { "method": "POST", "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/versions", "params": [ { "name": "apiId", "value": "", "type": "path", "description": "The UUID API identifier" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a version (OpenAPI or AsyncAPI) for an API.\n" }, { "info": { "name": "Get an API Version", "type": "http" }, "http": { "method": "GET", "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/versions/:versionId", "params": [ { "name": "apiId", "value": "", "type": "path", "description": "The UUID API identifier" }, { "name": "versionId", "value": "", "type": "path", "description": "The API version identifier" } ] }, "docs": "Fetches the version (OpenAPI or AsyncAPI) of an API." }, { "info": { "name": "Update API Version", "type": "http" }, "http": { "method": "PATCH", "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/versions/:versionId", "params": [ { "name": "apiId", "value": "", "type": "path", "description": "The UUID API identifier" }, { "name": "versionId", "value": "", "type": "path", "description": "The API version identifier" }, { "name": "force", "value": "", "type": "query", "description": "If true, allows operations to be removed from the current version when using access control enforcement.\nIf false, operations removal will be rejected with a 409 error.\nOmitting the value (i.e., setting `?force`) means true.\n" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates the version (OpenAPI or AsyncAPI) of an API." }, { "info": { "name": "Delete API Version", "type": "http" }, "http": { "method": "DELETE", "url": "{protocol}://{hostname}:{port}{path}/v3/apis/:apiId/versions/:versionId", "params": [ { "name": "apiId", "value": "", "type": "path", "description": "The UUID API identifier" }, { "name": "versionId", "value": "", "type": "path", "description": "The API version identifier" } ] }, "docs": "Deletes the version (OpenAPI or AsyncAPI) of an API." } ] } ], "bundled": true }