PATCH/users/{principalId}

Update a portal user

Update a portal user's profile and attributes. User attributes must be configured in Settings > User Attributes before they can be set.

Parameters

Name	In	Type	Description
`principalId`required	path	`string`	Principal ID

Request body

Field	Type	Description
`name`	`string`	Display name
`image`	`string \| null`	Profile image URL
`emailVerified`	`boolean`	Email verification status
`externalId`	`stringnull`	Your system's user ID (null to unset)
`attributes`	`object`	User attributes (must be configured in Settings > User Attributes)

Response

Updated portal user

Field	Type	Description
`principalId`required	`string`	Principal ID
`userId`required	`string`	User ID
`name`required	`string`
`email`required	`string`
`image`required	`stringnull`	Profile image URL
`emailVerified`required	`boolean`	Whether email is verified
`externalId`required	`stringnull`	Customer-provided external user ID
`attributes`required	`object`	User attributes (must be configured in Settings > User Attributes)
`createdAt`required	`string`	Account creation date

Errors

400Validation error (invalid attributes)

401Unauthorized

404Portal user not found

Example request

curl \
  -X PATCH \
  "https://feedback.quackback.io/api/v1/users/:principalId" \
  -H "Authorization: Bearer qb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "example_name",
  "emailVerified": false
}'