Update a member's details

Updates one or more fields on a member. At least one field must be provided in the request body.

You can change a member's email, displayName, paid status, or status. Setting status to 'blocked' prevents the member from accessing the site. Setting it back to 'active' restores access.

The accessGroups field in the response is read-only — to manage group membership, use the Group Members endpoints (addGroupMember, removeGroupMember).

Returns 409 Conflict if the new email conflicts with an existing member on this site.

PATCH /api/v1/members/{memberId}

Bearer token

curl 'https://api.sotion.so/api/v1/members/123e4567-e89b-42d3-a456-426614174000' \
  --request PATCH \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "[email protected]",
  "displayName": "example",
  "paid": true,
  "status": "active"
}'

{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "email": "[email protected]",
    "displayName": "example",
    "status": "active",
    "verified": true,
    "paid": true,
    "registeredAt": "2026-01-01T12:00:00Z",
    "lastLoginAt": "2026-01-01T12:00:00Z",
    "createdAt": "2026-01-01T12:00:00Z",
    "updatedAt": "2026-01-01T12:00:00Z",
    "accessGroups": [
      {
        "id": "123e4567-e89b-42d3-a456-426614174000",
        "name": "example"
      }
    ]
  }
}

Member updated.

Path parameters

· 1

memberId string · uuid required

UUID of the member. Get member IDs from listMembers or createMember responses.

Body

· UpdateMemberRequest

required application/json

email string · email· max length: 320

New email address. Will be normalized to lowercase. Returns 409 if it conflicts with another member.

displayName string · max length: 200· nullable

New display name, or null to clear.

paid boolean

Update the paid status.

status string · enum

Set to 'active' to allow access or 'blocked' to deny access.

values

active
blocked

Path parameters

Body

Responses