People
Get a workspace-scoped person profile
/api/v1/workspaces/{workspace_id}/people/{username}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
Responses
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·min 3·max 30Globally 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.
string·max 100Custom status text from Account Profile settings (distinct from the membership status); null when unset.
string·max 2048Workspace-authorized uploaded image route or external HTTPS Account Profile image; null when unset.
string·min 1·max 2Account-owned avatar letters override; null derives letters from the display name.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Read a workspace member's uploaded profile picture
/api/v1/workspaces/{workspace_id}/people/{user_id}/profile-picture/contentRedirects an authorized Workspace member to a short-lived object-storage URL. The target must still be an active member of the same Workspace.
Path Parameters
Responses
List a person's visible workspace activity
/api/v1/workspaces/{workspace_id}/people/{username}/activityReturns the requested active member's human-readable activity, newest first. It uses the same redaction and current-access rules as Workspace Activity and never returns raw audit events.
Path Parameters
Query Parameters
Responses
integer <int64>·min 0Authorized collection size before cursor bounds; refreshed at read time. Activity counts admitted events before display grouping and Comments include retained ordinals.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.