---
id: config-update-digital-wallet-open-id-individual-wallet-app
title: "Update wallet app"
description: "Replaces the values of a wallet app. Send the whole app: a member that you leave out is cleared (for example `minimumVersion`: no minimum). Only the Play Integrity keys work differently: an update without them keeps the stored keys, and an update with both replaces them. The platform of an app does not change."
sidebar_label: "Update wallet app"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "put 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"}>Update wallet app</h1>

<MethodEndpoint method={"put"} path={"/v4/config/ows/wallet-provider/individual-wallet-apps/{walletAppId}"}></MethodEndpoint>



Replaces the values of a wallet app. Send the whole app: a member that you leave out is cleared (for example `minimumVersion`: no minimum). Only the Play Integrity keys work differently: an update without them keeps the stored keys, and an update with both replaces them. The platform of an app does not change.

A new `minimumVersion` applies to the next signed request: a request with an older `X-Wallet-App-Version` gets `403` with `individual_wallet_unit.app_version_too_old`, and the app asks the user to update it.

## Request

<details style={{"marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{}}><h3 className={"openapi-markdown__details-summary-header-params"}>Path Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"description":"The `id` of the wallet app, from the list of the wallet apps. A deleted app gives 404.","in":"path","name":"walletAppId","required":true,"schema":{"type":"string","format":"uuid"}}}></ParamsItem></ul></div></details><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 values of the wallet app.

</div></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** `non-empty` and `<= 100 characters`"} schema={{"type":"string","minLength":1,"maxLength":100,"description":"Required. The name of the app in the dashboard.","example":"Data Wallet Android"}}></SchemaItem><SchemaItem collapsible={false} name={"platform"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`ios`, `android`]"} schema={{"type":"string","description":"Required. `ios` or `android`. An update cannot change the platform of an app.","enum":["ios","android"],"example":"android"}}></SchemaItem><SchemaItem collapsible={false} name={"iosTeamId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"iOS: the Apple Team ID of the developer account, 10 capital letters and digits.","example":"8XK2M4Q7ZD"}}></SchemaItem><SchemaItem collapsible={false} name={"iosBundleId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"iOS: the bundle ID of the app, for example `io.igrant.datawallet`.","example":"io.igrant.datawallet"}}></SchemaItem><SchemaItem collapsible={false} name={"androidPackageName"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Android: the package name (application ID) of the app, for example `io.igrant.datawallet`.","example":"io.igrant.datawallet"}}></SchemaItem><SchemaItem collapsible={false} name={"androidSigningCertificateDigests"} required={false} schemaName={"string[]"} qualifierMessage={"**Possible values:** `<= 20`"} schema={{"type":"array","maxItems":20,"description":"Android: the SHA-256 digest of the app signing certificate, as the Play Console shows it under App integrity > App signing (the certificate of the Play app signing key). Add another digest only for a build that is signed with another certificate. 64 hexadecimal digits; colons and capital letters are accepted, and the answer has the lowercase form without colons.","items":{"type":"string"},"example":["9F:86:D0:81:88:4C:7D:65:9A:2F:EA:A0:C5:5A:D0:15:A3:BF:4F:1B:2B:0B:82:2C:D1:5D:6C:15:B0:F0:0A:08"]}}></SchemaItem><SchemaItem collapsible={false} name={"playIntegrityDecryptionKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Android: the decryption key of the classic Play Integrity requests of the app, the base64 of an AES-256 key. Get it in the Play Console under App integrity > Play Integrity API > Settings > Classic requests > Manage response encryption keys. Write-only: it is stored encrypted and is never in an answer. Send it together with `playIntegrityVerificationKey`. An update without the two keys keeps the stored keys.","example":"<base64 of the AES-256 decryption key>"}}></SchemaItem><SchemaItem collapsible={false} name={"playIntegrityVerificationKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Android: the verification key of the classic Play Integrity requests of the app, the base64 of the DER public key (an EC P-256 key), from the same page of the Play Console. Write-only, as `playIntegrityDecryptionKey`.","example":"<base64 of the DER EC P-256 verification key>"}}></SchemaItem><SchemaItem collapsible={false} name={"minimumVersion"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Optional. The lowest app version (dotted numbers, for example `2026.12.0`) that the wallet provider accepts in a signed request. Without it, or with `null`: no minimum.","example":"2026.12.0"}}></SchemaItem><SchemaItem collapsible={false} name={"androidMinimumVersionCode"} required={false} schemaName={"integer"} qualifierMessage={"**Possible values:** `<= 2100000000`"} schema={{"type":"integer","minimum":0,"maximum":2100000000,"description":"Optional. Android: the lowest `versionCode` of the app that the wallet provider accepts. For a `release` build, the wallet provider compares it with the app version in each Android Key Attestation chain (the registration, a key attestation request and the fresh chain of a Wallet Unit Attestation request), and refuses a lower or missing version with `403` (`app_version_too_old`). Without it, or with `0`: every version. An update without it sets it to `0`.","example":2026120001}}></SchemaItem><SchemaItem collapsible={false} name={"build"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** [`release`, `development`, `simulator`]"} schema={{"type":"string","description":"Optional. The build of the app, which decides the device evidence that a request of its wallet units must give. `release` (the default of a create): every check. `development`: the wallet provider accepts the App Attest development environment (iOS) and needs no Play Integrity token (Android). `simulator`: it checks only the request signature. An update without it keeps the stored build. Another value gives `400` (`build: must be release, development or simulator`).","enum":["release","development","simulator"],"example":"release"}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

The wallet app after the change.

</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"}>walletApp</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

An iOS or Android app of the wallet solution. The wallet provider uses the apps for each request: it registers a wallet unit only for an app that is ready, and it checks the app identity of the device evidence against the app. The answer never has the Play Integrity keys.

</div><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid","description":"The id of the wallet app.","example":"5b0c6f0e-8f6d-4d2a-9a51-3f7a2c1e9b42"}}></SchemaItem><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The name of the app in the dashboard.","example":"Data Wallet Android"}}></SchemaItem><SchemaItem collapsible={false} name={"platform"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`ios`, `android`]"} schema={{"type":"string","description":"The platform of the app. It does not change after the create.","enum":["ios","android"],"example":"android"}}></SchemaItem><SchemaItem collapsible={false} name={"iosTeamId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"iOS: the Apple Team ID (10 capital letters and digits). The App ID of the app is `<iosTeamId>.<iosBundleId>`.","example":null}}></SchemaItem><SchemaItem collapsible={false} name={"iosBundleId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"iOS: the bundle ID of the app.","example":null}}></SchemaItem><SchemaItem collapsible={false} name={"androidPackageName"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"Android: the package name (application ID) of the app.","example":"io.igrant.datawallet"}}></SchemaItem><SchemaItem collapsible={false} name={"androidSigningCertificateDigests"} required={true} schemaName={"string[]"} qualifierMessage={"**Possible values:** Value must match regular expression `^[0-9a-f]{64}$`"} schema={{"type":"array","description":"Android: the SHA-256 digests of the app signing certificates, in lowercase hexadecimal (64 digits). An empty array for an iOS app.","example":["9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"],"items":{"type":"string","pattern":"^[0-9a-f]{64}$"}}}></SchemaItem><SchemaItem collapsible={false} name={"playIntegrityKeysSet"} required={true} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Android: `true` when the Play Integrity decryption key and verification key are stored. The keys themselves are never in an answer.","example":true}}></SchemaItem><SchemaItem collapsible={false} name={"minimumVersion"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The lowest app version (`X-Wallet-App-Version`, dotted numbers) that the wallet provider accepts in a signed request. `null`: no minimum.","example":"2026.12.0"}}></SchemaItem><SchemaItem collapsible={false} name={"androidMinimumVersionCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Android: the lowest app version code that the wallet provider accepts in the Android Key Attestation. `0`: every version.","example":0}}></SchemaItem><SchemaItem collapsible={false} name={"build"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`release`, `development`, `simulator`]"} schema={{"type":"string","description":"The build of the app: `release`, `development` or `simulator`. It decides the device evidence that a request of its wallet units must give.","enum":["release","development","simulator"],"example":"release"}}></SchemaItem><SchemaItem collapsible={false} name={"ready"} required={true} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"`true` when the app has every value that its checks need: the Team ID and the bundle ID (iOS), or the package name, a signing certificate digest and the Play Integrity keys (Android).","example":true}}></SchemaItem><SchemaItem collapsible={false} name={"notReadyReason"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`ios_app_id_missing`, `package_missing`, `digest_missing`, `play_integrity_keys_missing`]"} schema={{"type":"string","nullable":true,"description":"Why the app is not ready, or `null` for a ready app: `ios_app_id_missing`, `package_missing`, `digest_missing` or `play_integrity_keys_missing`.","enum":["ios_app_id_missing","package_missing","digest_missing","play_integrity_keys_missing"],"example":null}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>walletUnits</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"}}>

The wallet units of the app that are not deleted, by state.

</div><SchemaItem collapsible={false} name={"active"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":1840}}></SchemaItem><SchemaItem collapsible={false} name={"revoked"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":12}}></SchemaItem></div></details></SchemaItem><SchemaItem collapsible={false} name={"source"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`interface`, `installation`]"} schema={{"type":"string","description":"`installation`: the wallet provider made the app once from the values of the installation. `interface`: an admin or an API key made it.","enum":["interface","installation"],"example":"installation"}}></SchemaItem><SchemaItem collapsible={false} name={"createdAt"} required={true} schemaName={"int64"} qualifierMessage={undefined} schema={{"type":"integer","format":"int64","description":"When the app was made (Unix time in seconds).","example":1794556800}}></SchemaItem><SchemaItem collapsible={false} name={"updatedAt"} required={true} schemaName={"int64"} qualifierMessage={undefined} schema={{"type":"integer","format":"int64","description":"When the app last changed (Unix time in seconds).","example":1794560400}}></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"walletApp\": {\n    \"id\": \"5b0c6f0e-8f6d-4d2a-9a51-3f7a2c1e9b42\",\n    \"name\": \"Data Wallet Android\",\n    \"platform\": \"android\",\n    \"iosTeamId\": null,\n    \"iosBundleId\": null,\n    \"androidPackageName\": \"io.igrant.datawallet\",\n    \"androidSigningCertificateDigests\": [\n      \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n    ],\n    \"playIntegrityKeysSet\": true,\n    \"minimumVersion\": \"2026.12.0\",\n    \"androidMinimumVersionCode\": 0,\n    \"build\": \"release\",\n    \"ready\": true,\n    \"notReadyReason\": null,\n    \"walletUnits\": {\n      \"active\": 1840,\n      \"revoked\": 12\n    },\n    \"source\": \"installation\",\n    \"createdAt\": 1794556800,\n    \"updatedAt\": 1794560400\n  }\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"walletApp\": {\n    \"id\": \"5b0c6f0e-8f6d-4d2a-9a51-3f7a2c1e9b42\",\n    \"name\": \"Data Wallet Android\",\n    \"platform\": \"android\",\n    \"iosTeamId\": null,\n    \"iosBundleId\": null,\n    \"androidPackageName\": \"io.igrant.datawallet\",\n    \"androidSigningCertificateDigests\": [\n      \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n    ],\n    \"playIntegrityKeysSet\": true,\n    \"minimumVersion\": \"2026.12.0\",\n    \"androidMinimumVersionCode\": 2026120001,\n    \"build\": \"release\",\n    \"ready\": true,\n    \"notReadyReason\": null,\n    \"walletUnits\": {\n      \"active\": 1840,\n      \"revoked\": 12\n    },\n    \"source\": \"interface\",\n    \"createdAt\": 1794556800,\n    \"updatedAt\": 1794560400\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 `name` or `platform`, a `platform` other than `ios` or `android`, an `iosTeamId`, `iosBundleId`, `androidPackageName` or `minimumVersion` of another form, a digest that is not a SHA-256 in hexadecimal, one Play Integrity key without the other, a `playIntegrityDecryptionKey` that is not the base64 of a 256-bit AES key, or a `playIntegrityVerificationKey` that is not the base64 DER of an EC P-256 public key), a `platform` that is not the platform of the app, 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={"404"} value={"404"}><div>

No wallet app of the wallet provider has this id (also for a deleted app).

</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={"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>
      