Returns the active Workspace membership identity visible to the
caller. The canonical target is the User's current username. A
historical username resolves to the same User; a UUIDv7 is accepted
only as a temporary migration reference. This is a collaboration
profile, not account settings: it
carries the title, bio and status the person set in Account Profile
settings, and never exposes email, phone, or other private account
data. The returned actor_id
can be used with the normal Workspace Task list's
assignee_actor_id filter.
Path Parameters
workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
usernameRequired
string·min 3·max 36
Current or historical public username. UUIDv7 is accepted only for migration from pre-username profile links.
Responses
user_idRequired
string <uuid>
Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Example0198ac5e-f9b7-7000-8000-000000000001
actor_idRequired
string <uuid>
Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Example0198ac5e-f9b7-7000-8000-000000000001
display_nameRequired
string·min 1·max 100
usernameRequired
string·min 3·max 30
Globally unique mutable public account handle. New handles use lowercase letters, numbers, and interior dots and are initially derived from the email local part. Existing hyphen/underscore handles remain readable. Previously claimed values remain reserved to the same User.
Examplejane.doe
workspace_roleRequired
string
Values
owneradminmemberviewer
statusRequired
string
Values
active
is_youRequired
boolean
titleRequired
string·min 1·max 100
Job title or role from Account Profile settings; null when unset.
bioRequired
string·max 500
Short bio from Account Profile settings; null when unset.
profile_statusRequired
string·max 100
Custom status text from Account Profile settings (distinct from the membership status); null when unset.
profile_picture_urlRequired
string·max 2048
Workspace-authorized uploaded image route or external HTTPS Account Profile image; null when unset.
avatar_initialsRequired
string·min 1·max 2
Account-owned avatar letters override; null derives letters from the display name.
avatar_colorRequired
string·max 11
Account-owned avatar background; null predates AVATAR-001 and falls back to a deterministic palette pick.
Exampleindigo
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Retry-After
integer·min 0
Delay in seconds before retrying, when an expected maintenance end is known.
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
