--- updatedAt: 2026-06-04T14:04:49.000Z --- # Test chosen versions Tests the selected versions against the existing risk assessment rules. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Enterprise Application Access API", "url": "https://techdocs.akamai.com/eaa-api/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Device posture", "version": "v1" }, "openapi": "3.0.0", "paths": { "/device-posture/risk-assessment/chosen-versions/test": { "post": { "description": "Tests the selected versions against the existing risk assessment rules.", "externalDocs": { "description": "See documentation for this operation in Akamai's Enterprise Application Access API", "url": "https://techdocs.akamai.com/eaa-api/reference/post-chosen-versions-test" }, "operationId": "post-chosen-versions-test", "parameters": [ { "description": "The Akamai contract identifier for your Enterprise Application Access product.", "in": "query", "name": "contractId", "schema": { "example": "K-0N7RAK7", "type": "string" }, "x-akamai": { "file-path": "parameters/optional-contract-id-query.yaml" } }, { "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).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "browsers": [ { "custom": [ "11.0.155" ], "gracePeriod": 180, "name": "Internet Explorer" }, { "custom": [], "gracePeriod": 180, "name": "Opera" } ], "client": { "gracePeriod": 1, "name": "EAA Client" }, "eaaclient": [ { "custom": [], "gracePeriod": 180, "platform": "Android" }, { "custom": [], "gracePeriod": 180, "platform": "macOS", "upToDate": [ "10.13.7" ] }, { "custom": [], "gracePeriod": 180, "platform": "windows", "upToDate": [ "2.1.1" ] } ], "os": [ { "custom": [], "gracePeriod": 180, "name": "Android" }, { "custom": [ "17F77", "18A391", "18G1012", "18G84", "18G95", "18G103" ], "gracePeriod": 180, "name": "macOS", "upToDate": [ "Catalina 10.15.7 (19H15)", "Mojave 10.14.6 (18G1012)" ] }, { "custom": [ "18362.239", "7601.24511", "18362.295", "18362.356" ], "gracePeriod": 180, "name": "Windows", "upToDate": [ "2004 (19041.630)", "1909 (18363.1198)" ] } ] }, "schema": { "additionalProperties": false, "description": "The versions selected for different dimensions of device risk assessment.", "properties": { "browsers": { "description": "The browser version details.", "items": { "additionalProperties": false, "properties": { "custom": { "description": "Custom combinations of different browser versions.", "items": { "minLength": 1, "type": "string" }, "minItems": 0, "type": "array" }, "gracePeriod": { "description": "The number of days the previous version is valid until it's deprecated.", "minimum": 0, "type": "integer" }, "name": { "description": "The name of the web browser.", "minLength": 1, "type": "string" } }, "required": [ "custom", "gracePeriod", "name" ], "type": "object" }, "minItems": 1, "type": "array" }, "client": { "additionalProperties": false, "description": "The selected client versions.", "properties": { "gracePeriod": { "description": "The number of days the previous version is valid until it's deprecated.", "minimum": 0, "type": "integer" }, "name": { "description": "The name of the client.", "minLength": 1, "type": "string" } }, "required": [ "gracePeriod", "name" ], "type": "object" }, "eaaclient": { "description": "The per-OS version selections for EAA clients.", "items": { "additionalProperties": false, "properties": { "custom": { "description": "Custom combinations of different OS versions.", "items": { "minLength": 1, "type": "string" }, "minItems": 0, "type": "array" }, "gracePeriod": { "description": "The number of days the previous version is valid.", "minimum": 0, "type": "integer" }, "platform": { "description": "The platform on which the EAA client runs.", "minLength": 1, "type": "string" }, "upToDate": { "description": "Latest up-to-date OS version. Required only for macOS or Windows platforms.", "items": { "minLength": 1, "type": "string" }, "minItems": 1, "type": "array" } }, "type": "object" }, "minItems": 0, "type": "array" }, "os": { "description": "The selected operating system version details.", "items": { "additionalProperties": false, "properties": { "custom": { "description": "The OS version. For macOS this is the build number, such as `19H15` for macOS Catalina 10.15.7.", "items": { "minLength": 1, "type": "string" }, "minItems": 0, "type": "array" }, "gracePeriod": { "description": "The number of days the previous version is valid until it's deprecated.", "minimum": 0, "type": "integer" }, "name": { "description": "The name of the operating system.", "minLength": 1, "type": "string" }, "upToDate": { "description": "Latest up-to-date OS version. Required only for macOS or Windows platforms.", "items": { "minLength": 1, "type": "string" }, "minItems": 1, "type": "array" } }, "required": [ "custom", "gracePeriod", "name" ], "type": "object" }, "minItems": 0, "type": "array" } }, "required": [ "browsers", "client", "os", "eaaclient" ], "type": "object", "x-akamai": { "file-path": "schemas/chosen-versions.yaml" } } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": [ { "count": 19, "id": 298, "name": "Finance Tag", "tier": false }, { "count": 57, "id": 299, "name": "Engineering Tag", "tier": false }, { "count": 86, "id": 255, "name": "Low", "tier": true }, { "count": 15, "id": 256, "name": "Medium", "tier": true }, { "count": 150, "id": 257, "name": "High", "tier": true } ], "schema": { "description": "Device risk assessment rule information.", "items": { "additionalProperties": false, "properties": { "count": { "description": "The total number of devices that pass the criteria specified for this risk assessment rule.", "minimum": 0, "type": "integer" }, "id": { "description": "A unique identifier for this risk assessment rule.", "minimum": 0, "type": "integer" }, "name": { "description": "The name of the risk assessment rule.", "minLength": 1, "type": "string" }, "tier": { "description": "Whether the rule is a tier.", "type": "boolean" } }, "required": [ "id", "count", "name", "tier" ], "type": "object" }, "minItems": 1, "type": "array", "x-akamai": { "file-path": "schemas/risk-assessment.yaml" } } } }, "description": "Successful response." } }, "summary": "Test chosen versions", "tags": [ "Risk assessment" ] }, "x-akamai": { "file-path": "paths/test-chosen-versions.yaml", "path-info": "/device-posture/risk-assessment/chosen-versions/test" } } }, "servers": [ { "url": "https://{hostname}/crux/v1" } ], "tags": [ { "description": "Manage risks.", "name": "Risk assessment" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "07-device-posture.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [List available browser versions](https://techdocs.akamai.com/eaa-api/reference/get-available-browsers.md) * [List available client versions](https://techdocs.akamai.com/eaa-api/reference/get-client-versions.md) * [List available operating system versions](https://techdocs.akamai.com/eaa-api/reference/get-os-versions.md) * [Get CA and OCSP information](https://techdocs.akamai.com/eaa-api/reference/get-ca-ocsp.md) * [Create certificate profile](https://techdocs.akamai.com/eaa-api/reference/post-certificate-profile.md) * [List certificate profiles](https://techdocs.akamai.com/eaa-api/reference/get-certificate-profiles.md) * [Get certificate profile](https://techdocs.akamai.com/eaa-api/reference/get-certificate-profile.md) * [Update certificate profile](https://techdocs.akamai.com/eaa-api/reference/put-certificate-profile.md) * [Delete certificate profile](https://techdocs.akamai.com/eaa-api/reference/delete-certificate-profile.md) * [Create an anti-malware profile](https://techdocs.akamai.com/eaa-api/reference/post-anti-malware-profile.md) * [List anti-malware profiles](https://techdocs.akamai.com/eaa-api/reference/get-anti-malware-profiles.md) * [Get an anti-malware profile](https://techdocs.akamai.com/eaa-api/reference/get-anti-malware-profile.md) * [Update an anti-malware profile](https://techdocs.akamai.com/eaa-api/reference/put-anti-malware-profile.md) * [Delete an anti-malware profile](https://techdocs.akamai.com/eaa-api/reference/delete-anti-malware-profile.md) * [Get CA information](https://techdocs.akamai.com/eaa-api/reference/get-certificate-usage-ca.md) * [Get OCSP information](https://techdocs.akamai.com/eaa-api/reference/get-certificate-usage-ocsp.md) * [List chosen versions](https://techdocs.akamai.com/eaa-api/reference/get-chosen-versions.md) * [Modify chosen versions](https://techdocs.akamai.com/eaa-api/reference/put-chosen-versions.md) * [List available operating systems](https://techdocs.akamai.com/eaa-api/reference/get-os-names.md) * [Create a new Carbon Black integration](https://techdocs.akamai.com/eaa-api/reference/post-partner-carbon-black.md) * [List Carbon Black integrations](https://techdocs.akamai.com/eaa-api/reference/get-partner-carbon-black.md) * [Get Carbon Black integration status](https://techdocs.akamai.com/eaa-api/reference/get-partner-carbon-black-status.md) * [Update Carbon Black integration status](https://techdocs.akamai.com/eaa-api/reference/put-partner-carbon-black-status.md) * [Create a Carbon Black integration](https://techdocs.akamai.com/eaa-api/reference/post-partner-carbon-black-test.md) * [Creates a Carbon Black integration for testing](https://techdocs.akamai.com/eaa-api/reference/put-partner-carbon-black-test.md) * [Get a Carbon Black integration](https://techdocs.akamai.com/eaa-api/reference/get-partner-carbon-black-integration.md) * [Modify a Carbon Black integration](https://techdocs.akamai.com/eaa-api/reference/put-partner-carbon-black-integration.md) * [Delete a Carbon Black integration](https://techdocs.akamai.com/eaa-api/reference/delete-partner-carbon-black-integration.md) * [Create a new CrowdStrike integration](https://techdocs.akamai.com/eaa-api/reference/post-partner-crowdstrike.md) * [List CrowdStrike integrations](https://techdocs.akamai.com/eaa-api/reference/get-partner-crowdstrike.md) * [Get CrowdStrike integration status](https://techdocs.akamai.com/eaa-api/reference/get-partner-crowdstrike-status.md) * [Update CrowdStrike integration status](https://techdocs.akamai.com/eaa-api/reference/put-partner-crowdstrike-status.md) * [Create a CrowdStrike integration](https://techdocs.akamai.com/eaa-api/reference/post-partner-crowdstrike-test.md) * [Creates a CrowdStrike integration for testing](https://techdocs.akamai.com/eaa-api/reference/put-partner-crowdstrike-test.md) * [Get a CrowdStrike integration](https://techdocs.akamai.com/eaa-api/reference/get-partner-crowdstrike-integration.md) * [Modify a CrowdStrike integration](https://techdocs.akamai.com/eaa-api/reference/put-partner-crowdstrike-integration.md) * [Delete a CrowdStrike integration](https://techdocs.akamai.com/eaa-api/reference/delete-partner-crowdstrike-integration.md) * [List signal names](https://techdocs.akamai.com/eaa-api/reference/get-signal-names.md) * [Create risk tag](https://techdocs.akamai.com/eaa-api/reference/post-tag.md) * [List risk tags](https://techdocs.akamai.com/eaa-api/reference/get-tags.md) * [Get a risk tag](https://techdocs.akamai.com/eaa-api/reference/get-tag.md) * [Modify a risk tag](https://techdocs.akamai.com/eaa-api/reference/put-tag.md) * [Delete a tag](https://techdocs.akamai.com/eaa-api/reference/delete-tag.md) * [Test risk rule](https://techdocs.akamai.com/eaa-api/reference/put-test-ruleid.md) * [List risk tiers](https://techdocs.akamai.com/eaa-api/reference/get-tiers.md) * [Get a risk tier](https://techdocs.akamai.com/eaa-api/reference/get-tier.md) * [Modify risk tier](https://techdocs.akamai.com/eaa-api/reference/put-tier.md) * [List client versions](https://techdocs.akamai.com/eaa-api/reference/get-client-version.md)