Fetch User
User Endpoints
Fetch User
Get a user’s public profile by ID
Fetch User
Returns a user’s public profile by their Sublay user ID. Optionally includes associated file records for the avatar and banner.
If the profile owner has blocked the signed-in caller, this returns
404 — the
same response as a user who does not exist. The reverse is not true: a user
you have blocked stays visible, so you keep a way to find and unblock them. Requires the moderation bundle.Path Parameters
string
required
The Sublay user ID (UUID).
Query Parameters
string
Comma-separated list of associations to include. Pass
"files" to include
the processed avatarFile and bannerFile objects.Space-scoped reputation
This endpoint has no space in context, so the opt-inspaceReputation object accepts a spaceId of a space <uuid> or none only — context is rejected (400). It adds a spaceReputation field to each returned user, alongside the always-present reputation total. Requires the reputation bundle. See the Reputation data model.
Response
On success, returns HTTP200 with the user object:
string
Unique user ID (UUID).
string | null
External identifier linking this user to your system.
string
Project this user belongs to.
string | null
Display name.
string | null
Unique username within the project.
string | null
Avatar image URL.
string | null
Short bio text.
object | null
Public custom key-value data.
number
The user’s overall reputation total (the sum of all their reputation buckets).
This is a global lookup with no space in context, so it returns the total only —
see Reputation for space-scoped reads.
object | null
Processed avatar image with variants. Only present when
include=files is
requested.object | null
Processed banner image with variants. Only present when
include=files is
requested.string
ISO timestamp of account creation.
Error Responses
User Not Found — 404
User Not Found — 404
Invalid Params — 400
Invalid Params — 400

