Get User - Seamind

GET

api

shared

users

{user_id}

Get User

curl --request GET \
  --url https://api.example.com/api/v1/shared/users/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "role": "<string>",
  "state": "<string>",
  "lastLogin": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id

string<uuid>

required

Response

Successful Response

User info for admin view — hides technical fields.

role is the cached WorkOS membership role, used purely to render the crew table. Never read it for authorization.

string<uuid>

required

string

required

firstName

string

required

lastName

string

required

role

string

required

state

string

required

createdAt

string<date-time>

required

Update User RoleUpdate another user's WorkOS membership role. Two-phase write: the WorkOS membership is updated first (authoritative source). On success, the local `users.role` display cache is mirrored. On DB-mirror failure, structured logs flag the drift; the hourly reconciliation worker will heal it on its next run.

Get User

curl --request GET \
  --url https://api.example.com/api/v1/shared/users/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "role": "<string>",
  "state": "<string>",
  "lastLogin": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z"
}