---
title: "Update app user defaults"
method: PUT
path: "/v1/apps/user-defaults/{id}"
tags: ["Apps"]
---

# Update app user defaults

`PUT /v1/apps/user-defaults/{id}`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v1/apps/user-defaults/{id}`
- Auth: HTTP bearer

**Auth**: User JWT

App update

## Path parameters

- `id` string, required

## Request body

- object
  - `defaultProfileIsPublic` boolean: Default value of `profileIsPublic` for newly-created users in this app. If true, anyone in the app can view a new user's profile by default; if false, only the user themself + admins.
  - `defaultAssetsArePublic` boolean: Default value of `assetsArePublic` for newly-created users in this app. If true, a new user's owned tokens / assets are visible on their public profile by default; if false, hidden.
  - `allowUsersToBecomeTenants` boolean: If true, end-users of this app can become tenants themselves (create their own apps, take their account independent of this app). Used for the base app where any signup can spin up their own apps. Default false for child apps.
  - `defaultAccessProfileOpen` boolean: **Deprecated** - kept as a backward-compatible alias for `defaultProfileIsPublic`. New integrations should use `defaultProfileIsPublic`.
  - `defaultAccessAssetsOpen` boolean: **Deprecated** - kept as a backward-compatible alias for `defaultAssetsArePublic`. New integrations should use `defaultAssetsArePublic`.
  - `usersCanFree` boolean: **Deprecated** - kept as a backward-compatible alias for `allowUsersToBecomeTenants`. New integrations should use `allowUsersToBecomeTenants`.
  - `defaultRooms` DefaultRooms[]: Array of `{ jid, pinned }` describing the rooms pre-populated for new users when they first sign in. `jid` is the room's MUC JID (`<appId>_<chatId>@conference.<xmpp-host>`); `pinned: true` shows it at the top of the chat list.
    - `jid` string
    - `pinned` boolean

## Response `200`

```
{
    _id: string,
    displayName: string,
    domainName: string,
    creatorId: string,
    bundleId: string,
    primaryColor: string,
    coinSymbol: string,
    coinName: boolean,
    defaultAccessProfileOpen: boolean,
    defaultAccessAssetsOpen: boolean,
    usersCanFree: boolean,
    isUserDataEncrypted: boolean,
    parentAppId: boolean,
    isAllowedNewAppCreate: boolean,
    isBaseApp: boolean,
    defaultRooms: [{jid: string, pinned: boolean}],
    createdAt: string,
    updatedAt: string,
    appToken: string,
}
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Something wrong with input data (validations error & ACL error) ``` {error: string} ```
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)