updateMember

PATCH

/members/{memberId}

curl --request PATCH \
  --url http://localhost:8080/api/v1/members/per_01j9x3k8m2q4r5s6t7v8w9y0z1 \
  --header 'Content-Type: application/json' \
  --cookie hs_session=<hs_session> \
  --data '{ "role": "owner", "displayName": "example" }'

• Your Homestead (default port; replace with your address)

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

memberId

required

string

/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/

Request Body^required

Media typeapplication/json

object

role

string

Allowed values: owner member viewer

displayName

string

>= 1 characters <= 60 characters

Responses

200

Updated.

Media typeapplication/json

object

id

required

string

/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/

username

required

string

displayName

required

string

role

required

string

Allowed values: owner member viewer

locale

One of:

string

string

Allowed values: en zh-Hans th

null

null

theme

required

string

Allowed values: system light dark

textScale

required

number

>= 1 <= 1.6

reducedMotion

required

boolean

shareVisits

boolean

showAiSummaries

boolean

avatar

One of:

object

object

id

required

string

/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/

url

required

Signed URL, valid 24 h.

string

thumbUrl

string

cardUrl

string

posterUrl

string

mime

required

string

width

integer

height

integer

durationMs

integer

blurhash

string

alt

string

null

null

createdAt

required

string format: date-time

lastSeenAt

One of:

string

string format: date-time

null

null

Examples

Exampleseed

Derived from fixtures/seed.json.

{
  "avatar": null,
  "createdAt": "2026-09-27T09:00:00.000Z",
  "displayName": "สมชาย",
  "id": "mem_01j9gnwgka8c0bbep1kenhhwr9",
  "lastSeenAt": null,
  "locale": "th",
  "reducedMotion": false,
  "role": "member",
  "shareVisits": true,
  "showAiSummaries": true,
  "textScale": 1.3,
  "theme": "system",
  "username": "somchai"
}

409

Conflicts with current state.

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

code

required

string

i18nKey

string

detail

string

fields

Array<object>

object

path

required

string

code

required

string

i18nKey

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "i18nKey": "example",
  "detail": "example",
  "fields": [
    {
      "path": "example",
      "code": "example",
      "i18nKey": "example"
    }
  ]
}