---
id: config-create-digital-wallet-open-id-vulnerable-device-class
title: "Create vulnerable device class"
description: "Adds a vulnerable device class: an Android device model, with all its Android versions or only some. `createdBy` is the caller. The device policy applies to the Android requests: the registration of a wallet unit, each Wallet Unit Attestation request and each key attestation request. A refused request gets `403` with `individual_wallet_unit.device_refused`. To revoke the wallet units that are registered on such devices already, run [Scan device policy](/docs/openid4vc-api/config-scan-digital-wallet-open-id-device- policy)."
sidebar_label: "Create vulnerable device class"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/openid4vc-api/igrant-io-api-documentation
custom_edit_url: null
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```


import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>Create vulnerable device class</h1>

<MethodEndpoint method={"post"} path={"/v4/config/ows/wallet-provider/individual-wallet-unit-device-policy/vulnerable-device-classes"}></MethodEndpoint>



Adds a vulnerable device class: an Android device model, with all its Android versions or only some. `createdBy` is the caller. The device policy applies to the Android requests: the registration of a wallet unit, each Wallet Unit Attestation request and each key attestation request. A refused request gets `403` with `individual_wallet_unit.device_refused`. To revoke the wallet units that are registered on such devices already, run [Scan device policy](/docs/openid4vc-api/config-scan-digital-wallet-open-id-device- policy).

## Request

<MimeTabs className={"openapi-tabs__mime"}><TabItem label={"application/json"} value={"application/json-schema"}><details style={{}} className={"openapi-markdown__details mime"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-mime"}><h3 className={"openapi-markdown__details-summary-header-body"}>Body</h3><strong className={"openapi-schema__required"}>required</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}><div style={{"marginTop":"1rem","marginBottom":"1rem"}}>

The new vulnerable device class.

</div></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"deviceModel"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** `non-empty` and `<= 100 characters`"} schema={{"type":"string","minLength":1,"maxLength":100,"description":"Required. The manufacturer and the model, exactly as the app sends them in `X-Wallet-Device-Model` (`Build.MANUFACTURER`, a space, `Build.MODEL`).","example":"samsung SM-A125F"}}></SchemaItem><SchemaItem collapsible={false} name={"androidVersions"} required={false} schemaName={"integer[]"} qualifierMessage={"**Possible values:** `>= 1` and `<= 99`"} schema={{"type":"array","nullable":true,"description":"Optional. The major Android versions of the class (1 to 99). Without it, with `null` or with an empty array: every version.","items":{"type":"integer","minimum":1,"maximum":99},"example":[11,12]}}></SchemaItem><SchemaItem collapsible={false} name={"fixedFromPatchLevel"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** Value must match regular expression `^(19[7-9][0-9]|[2-9][0-9]{3})-(0[1-9]|1[0-2])$`"} schema={{"type":"string","nullable":true,"pattern":"^(19[7-9][0-9]|[2-9][0-9]{3})-(0[1-9]|1[0-2])$","description":"Optional. The security update that fixes the class (YYYY-MM). Phones with this security update or a later one are not refused. Without it or with `null`: no fix.","example":"2026-11"}}></SchemaItem><SchemaItem collapsible={false} name={"reason"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** `<= 1000 characters`"} schema={{"type":"string","maxLength":1000,"description":"Optional. Why the class is refused.","example":"Vulnerable TEE firmware (vendor bulletin of October 2026)"}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"201"} value={"201"}><div>

The new vulnerable device class.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>vulnerableDeviceClass</strong><span className={"openapi-schema__name"}> object</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

A class of Android devices that the wallet provider refuses: a device model, with all its Android versions or only some of them.

</div><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid","description":"The id of the device class.","example":"0f3c2a1b-7d6e-4f50-9a8b-1c2d3e4f5a6b"}}></SchemaItem><SchemaItem collapsible={false} name={"deviceModel"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The manufacturer and the model, as the app sends them in `X-Wallet-Device-Model` (`Build.MANUFACTURER`, a space, `Build.MODEL`).","example":"samsung SM-A125F"}}></SchemaItem><SchemaItem collapsible={false} name={"androidVersions"} required={true} schemaName={"integer[]"} qualifierMessage={"**Possible values:** `>= 1` and `<= 99`"} schema={{"type":"array","nullable":true,"description":"The major Android versions of the class, from the attested OS version of the device. `null`: every version.","items":{"type":"integer","minimum":1,"maximum":99},"example":[11,12]}}></SchemaItem><SchemaItem collapsible={false} name={"fixedFromPatchLevel"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The security update that fixes the class (YYYY-MM). Phones with this security update or a later one are not refused. `null`: no fix.","example":"2026-11"}}></SchemaItem><SchemaItem collapsible={false} name={"reason"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"Why the class is refused, as the admin wrote it.","example":"Vulnerable TEE firmware (vendor bulletin of October 2026)"}}></SchemaItem><SchemaItem collapsible={false} name={"createdAt"} required={true} schemaName={"int64"} qualifierMessage={undefined} schema={{"type":"integer","format":"int64","description":"When the entry was added (Unix time in seconds).","example":1794556800}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>createdBy</strong><span className={"openapi-schema__name"}> object</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__nullable"}>nullable</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

Who added the entry: an admin (with the admin id) or an API key (with the name of the key).

</div><SchemaItem collapsible={false} name={"kind"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`admin`, `api_key`]"} schema={{"type":"string","description":"`admin` for the login of an admin, `api_key` for an API key.","enum":["admin","api_key"],"example":"admin"}}></SchemaItem><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The id of the admin, for `admin`. The dashboard shows the name of the admin. `null` for an API key.","example":"6a1f0c2b9e4d3a7f8b6c5d41"}}></SchemaItem><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The name of the API key, for `api_key`. `null` for an admin.","example":null}}></SchemaItem></div></details></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"vulnerableDeviceClass\": {\n    \"id\": \"0f3c2a1b-7d6e-4f50-9a8b-1c2d3e4f5a6b\",\n    \"deviceModel\": \"samsung SM-A125F\",\n    \"androidVersions\": [\n      11,\n      12\n    ],\n    \"fixedFromPatchLevel\": \"2026-11\",\n    \"reason\": \"Vulnerable TEE firmware (vendor bulletin of October 2026)\",\n    \"createdAt\": 1794556800,\n    \"createdBy\": {\n      \"kind\": \"admin\",\n      \"id\": \"6a1f0c2b9e4d3a7f8b6c5d41\",\n      \"name\": null\n    }\n  }\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"vulnerableDeviceClass\": {\n    \"id\": \"0f3c2a1b-7d6e-4f50-9a8b-1c2d3e4f5a6b\",\n    \"deviceModel\": \"samsung SM-A125F\",\n    \"androidVersions\": [\n      11,\n      12\n    ],\n    \"fixedFromPatchLevel\": \"2026-11\",\n    \"reason\": \"Vulnerable TEE firmware (vendor bulletin of October 2026)\",\n    \"createdAt\": 1794556800,\n    \"createdBy\": {\n      \"kind\": \"admin\",\n      \"id\": \"6a1f0c2b9e4d3a7f8b6c5d41\",\n      \"name\": null\n    }\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The body is not valid (an unknown member, a value of the wrong JSON type, a missing `deviceModel`, an Android version that is not a whole number from 1 to 99, or a `fixedFromPatchLevel` that is not a month YYYY-MM), or the organisation is not the wallet provider (also without a deployment).

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"401"} value={"401"}><div>

The `Authorization` header is missing, or the API key or token is not valid.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"403"} value={"403"}><div>

The API key or token does not allow this call. An API key without the scope of the operation gets the older body `{"Code", "Message"}`. An `X-SandboxOrgId` header that names another sandbox organisation than the one of the API key gets `{"errorCode", "errorDescription"}`. When a platform admin has turned off the feature of the operation for the organisation, the answer has `errorKey` `feature_disabled` and the member `feature` (the name of the feature).

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><div><span className={"badge badge--info"}>anyOf</span><SchemaTabs><TabItem label={"MOD1"} value={"0-item-properties"}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></TabItem><TabItem label={"Older error body"} value={"1-item-properties"}><SchemaItem collapsible={false} name={"Code"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"The HTTP status.","example":403}}></SchemaItem><SchemaItem collapsible={false} name={"Message"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"What went wrong.","example":"Unauthorised access;User doesn't have enough permissions;"}}></SchemaItem></TabItem></SchemaTabs></div></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"Code\": 403,\n  \"Message\": \"Unauthorised access;User doesn't have enough permissions;\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>

Unexpected server error.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>
      