Skip to main content
Update My Membership
Edits the acting user’s own title on a workspace: the token’s user, or the user a service key names in actingUserId. me in the path always means that user. It is self-service: no capability is needed. Only title can be edited here. A member’s other fields (metadata, capabilities, permissions, rank, relativeRank) are edited by a member with the capability, through Update Member; sending one here is refused with 400 workspace/unsupported-param. The route edits the acting user’s own direct member row on this workspace. The workspace owner has no member row, so they have no title and this route answers them 404 workspace/not-found. The same 404 goes to a user who only reaches in from an ancestor workspace and holds no row here. A user with no relation to the workspace at all gets the roster-visibility 404.
Your own membership is /workspaces/:workspaceId/members/me: GET to read it, PATCH to edit your title, DELETE to leave. The /workspaces/:workspaceId/members/:userId routes act on other members and refuse your own id with 400 workspace/own-member-id.

Path Parameters

string
required
The workspace UUID.

Body Parameters

string | null
required
Your new title: trimmed, up to 100 characters. null clears it. A cosmetic label with no authority.
string
Service keys only, and required with one: the user whose own title is edited. A key that names nobody is refused with 400 workspace/missing-user-id. A user token always acts as its own user and must not send it (400 workspace/acting-user-not-allowed). See Acting on behalf of a user.

Response

Returns the updated WorkspaceMember object, the same record Update Member returns.

Error Responses

Sent for metadata, capabilities, permissions, rank or relativeRank, whoever sends it; param names the field. Nothing is written.
title is missing, the wrong type or longer than 100 characters:
Any other unknown key is refused too:
A service key sent no actingUserId. me is the acting user, so the key must name one.
A user token sent actingUserId, even naming its own user.
A field this endpoint reads from the body was sent in the query string.
Returned when a service key names an actingUserId that isn’t a user in this project.
The workspace doesn’t exist, or the acting user has no relation to it:
The acting user has no direct member row on this workspace (the owner, or a user who only reaches in from an ancestor), including when the row was removed while this request was being handled:
See also: useUpdateMyWorkspaceMembership · Fetch My Membership · Update Member