Update wallet app
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.
Authorizations
AuthorizationstringheaderrequiredYour API key with the prefix
ApiKey:ApiKey <your-api-key>. Get an API key.Scope:
individual-wallet-units:update
Path parameters
walletApp Id string<uuid>requiredThe
idof the wallet app, from the list of the wallet apps. A deleted app gives 404.
Body
The new values of the wallet app.
namestringrequiredRequired. The name of the app in the dashboard.
1 to 100 characters.
Example:
"Data Wallet Android"platformenum<string>requiredRequired.
iosorandroid. An update cannot change the platform of an app.Available options:
ios,androidExample:
"android"iosTeam Id stringiOS: the Apple Team ID of the developer account, 10 capital letters and digits.
Example:
"8XK2M4Q7ZD"iosBundle Id stringiOS: the bundle ID of the app, for example
io.igrant.datawallet.Example:
"io.igrant.datawallet"androidPackage Name stringAndroid: the package name (application ID) of the app, for example
io.igrant.datawallet.Example:
"io.igrant.datawallet"androidSigning Certificate Digests string[]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.
At most 20 items.
playIntegrity Decryption Key stringAndroid: 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>"playIntegrity Verification Key stringAndroid: 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>"minimumVersion stringOptional. The lowest app version (dotted numbers, for example
2026.12.0) that the wallet provider accepts in a signed request. Without it, or withnull: no minimum.Example:
"2026.12.0"androidMinimum Version Code integerOptional. Android: the lowest
versionCodeof the app that the wallet provider accepts. For areleasebuild, 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 with403(app_version_too_old). Without it, or with0: every version. An update without it sets it to0.From 0 to 2100000000.
Example:
2026120001buildenum<string>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 gives400(build: must be release, development or simulator).Available options:
release,development,simulatorExample:
"release"
Response
The wallet app after the change.
walletApp objectThe wallet app.