Update app settings
/settings/appUpdates the progressive web app (PWA) settings. Only the fields included in the request are changed: setting a field to null clears its configured value and restores the default, and omitted fields are left unchanged. Images are referenced by the ID of a file that belongs to the account.
android.package and android.sha256_fingerprint must be provided together.
To avoid overwriting a newer version, send the ETag returned by the retrieve operation in the If-Match header. The header is optional; when it is omitted, the update is applied to the current revision.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/settings/app" \ -H "Content-Type: application/json" \ -d '{}'{ "data": { "android": { "package": "string", "sha256_fingerprint": "string" }, "defaults": {}, "icon": { "file_id": "string", "url": "string" }, "name": "string", "object": "settings", "propagation": {}, "replica": {}, "revision": "string", "screenshots": [ { "file_id": "string", "url": "string" } ], "theme_color": "string" }}Retrieve app settings GET
Returns the progressive web app (PWA) settings of the account: name, icon, theme color, Android app association, and screenshots. The response includes an `ETag` representing the current revision. Send this value in the `If-Match` header when updating these settings to avoid overwriting a newer version.
Retrieve branding settings GET
Returns the branding settings of the account: accent color, logo, favicon, and certificate logos. The response includes an `ETag` representing the current revision. Send this value in the `If-Match` header when updating these settings to avoid overwriting a newer version.