---
title: "Update a User"
method: PATCH
path: "/users/"
---

# Update a User

`PATCH /users/`

Update the profile of a user by specifying their `userId` and `platform` as query parameters. A `200` response with `{"status": "update in progress"}` confirms the request was accepted and is being processed asynchronously.

### Caution: Read-only fields

The following profile fields can't be updated. Don't include any of these keys in the request body:
- Any key prefixed with `aiq` or `_`
- `userId`, `gcmId`, `mTime`, `firstUserId`, `active`, `display_language`, `daysActive`, `identified`, `permission`, `sdkVersion`, `installSource`, `installType`, `subscribed`, `subscription`, `referrer_timestamp_seconds`, `referrer`, `wUserId`, `uninstallTime`

## Query parameters

- `userId` string, required
- `platform` 'android' | 'ios' | 'web' | 'offline', required

## Headers

- `appid` string, required
- `authorization` string, required

## Request body

- object

## Response `200`

Success. The update request has been accepted and is being processed asynchronously.

- object
  - `status` string — Indicates that the update request was accepted and is being processed.

## Other responses

- `400` — Bad Request. The request is malformed or contains invalid parameters.
- `404` — Not Found. No user profile was found for the specified `userId` and `platform` combination.

---

[API](https://skmtc.net/appier/apis/retrieve-a-user.md) · [All operations](https://skmtc.net/appier/apis/retrieve-a-user/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appier/retrieve-a-user/versions/2885365fa9c9/schema)
