Update User

Update a user’s profile information. Providing a parameter will overwrite the existing value.

PATCH `/users/:id`

Parameter	Type	Required	Description
`id`	string	Yes	The unique ID or alias of the user to update.

Parameter	Type	Required	Description
`alias`	string	No	New alias for the user. Must be globally unique.
`name`	string	No	User’s full name.
`description`	string	No	A short bio or description.
`url`	string	No	URL to a personal website or profile.

Returns {"status": "success"} — no body beyond the status.

Status	Error	Cause
400	`invalid_request_body`	Malformed body, or an extra field.
400	`account_retired`	The target is a service account that has already been retired.
403	`forbidden`	Not the target user.
400	`alias_not_supported`	The target is a service account, which never has an alias.
400	`alias_reserved`	`alias` is `me` or `target` — both reserved by the platform.
400	`alias_in_use`	The requested alias is already taken.
400	`alias_already_set`	The user’s alias has already been set and cannot be changed.

{
  "name": "Jane Doe-Smith",
  "description": "AI Researcher"
}

{
  "status": "success"
}

The id parameter accepts a UUID, alias, or me.

Only the user themselves can update their profile. Requests targeting a different user return 403 Forbidden.

The alias field can only be set once. Attempting to change an existing alias returns an error.