Ctrl+K

Upsert user properties

put/api/usermanagement/v1/users/{userId}/properties

Creates or replaces all properties for a specific user.

Path Parameters

  • userIdstringRequired
    External user ID

Request Body

User properties to upsert
userId string required
External user ID
guidedChecklist object
track string required
Guided checklist track
Allowed values: A B
roles array[string]
The user's roles in the requested organization, resolved at read time from role-user membership. Used by the server to filter visible steps. Values written via PUT/PATCH are stored but overwritten on GET by the resolved values, so this field always reflects the user's current roles in the org rather than a stored snapshot.
productInterests array[string]
User product interests
steps array[object]
Checklist steps
computedAt string <date-time>required
When the checklist was last computed
completedAt string <date-time>
When the checklist was completed
dismissedAt string <date-time>
When the checklist was dismissed
createdDate string <date-time>required
When the record was created
modifiedDate string <date-time>required
When the record was last modified

200 Response

userId string required
External user ID
guidedChecklist object
track string required
Guided checklist track
Allowed values: A B
roles array[string]
The user's roles in the requested organization, resolved at read time from role-user membership. Used by the server to filter visible steps. Values written via PUT/PATCH are stored but overwritten on GET by the resolved values, so this field always reflects the user's current roles in the org rather than a stored snapshot.
productInterests array[string]
User product interests
steps array[object]
Checklist steps
computedAt string <date-time>required
When the checklist was last computed
completedAt string <date-time>
When the checklist was completed
dismissedAt string <date-time>
When the checklist was dismissed
createdDate string <date-time>required
When the record was created
modifiedDate string <date-time>required
When the record was last modified