Merge User Traits
Merge User Traits
Merges traits into the profile — null deletes a key, absent keys are kept. 200 {"success":true}. create=false returns 404 for unknown users instead of creating the profile
Errors arrive as RFC 9457 problem+json with a machine-readable `code`:
| Status | `code` | Cause and fix |
| --- | --- | --- |
| `400` | `INVALID_USER_ID` | The `userId` path segment is empty or over 255 characters. Percent-encode the segment — `auth0|abc`-style IDs round-trip intact. |
| `400` | `INVALID_TRAITS` | The traits object is malformed or over 2,048 bytes serialized (`cap` names the limit). |
| `403` | — | The key lacks `users:write` — the error names the missing scope. |
| `404` | `USER_NOT_FOUND` | No profile exists and `create=false` was passed. Skip and count, or omit it to create the profile. |
PATCH
Merge User Traits
Authorizations
An API key created in your account settings, sent as Authorization: Bearer <key>.
Query Parameters
Available options:
true, false Body
application/json
Response
Success.