client.membersOperation methods
Parameter declarations below are taken from the pinned TypeScript source. Request fields and responses are summarized from the matching OpenAPI operation; follow the API link for every field, constraint, example, and error description.
/membersmembers.list
Use this operation to list workspace members. It returns only resources visible to the credential and applies the documented filters before producing a bounded, stable page. Required scopes, product permissions, sharing rules, workspace locks, and regional cell ownership are enforced for every request.
client.members.list(options: MemberListOptions = {})- Return form
Promise- Operation ID
listMembers- Required scopes
members:read- SDK parameters
options: MemberListOptions- Query request fields
cursor?: stringlimit?: integerincludePii?: boolean- Success
200 Array<Member> envelope
/members/{id}members.get
Use this operation to get a workspace member. It returns the resource only when it belongs to the authenticated workspace and is visible to the credential. Required scopes, product permissions, sharing rules, workspace locks, and regional cell ownership are enforced for every request.
client.members.get(id: string, options: AdministrationPiiOptions = {})- Return form
Promise- Operation ID
getMember- Required scopes
members:read- SDK parameters
id: stringoptions: AdministrationPiiOptions- Path request fields
id: string- Query request fields
includePii?: boolean- Success
200 Member envelope
/members/{id}/rolemembers.updateRole
Use this operation to change a member role. Only documented mutable fields are accepted; omitted fields retain their current values unless the request schema states replacement semantics. Required scopes, product permissions, sharing rules, workspace locks, and regional cell ownership are enforced for every request. Send the latest strong ETag in If-Match; stale revisions fail without overwriting a concurrent change.
client.members.updateRole(id: string, data: MemberRoleUpdate, options: AdministrationMutationOptions)- Return form
Promise- Operation ID
updateMemberRole- Required scopes
members:write- SDK parameters
id: stringdata: MemberRoleUpdateoptions: AdministrationMutationOptions- Path request fields
id: string- Header request fields
If-Match: string- Request body
MemberRoleUpdateapplication/json- Success
200 Member envelope
/members/{id}members.remove
Use this operation to remove a workspace member. The operation preserves TeamGrid lifecycle and permission rules instead of bypassing them with a direct data deletion. Required scopes, product permissions, sharing rules, workspace locks, and regional cell ownership are enforced for every request. Send the latest strong ETag in If-Match; stale revisions fail without overwriting a concurrent change.
client.members.remove(id: string, options: AdministrationMutationOptions)- Return form
Promise- Operation ID
removeMember- Required scopes
members:write- SDK parameters
id: stringoptions: AdministrationMutationOptions- Path request fields
id: string- Header request fields
If-Match: string- Success
204
Convenience helpers
These typed helpers compose mapped operations. They do not grant scopes or bypass API limits.
members.pages
Iterate cursor pages with a bounded PaginationOptions policy.
client.members.pages(options: MemberListOptions = {}, pagination?: PaginationOptions)AsyncGeneratorErrors and transport metadata
HTTP failures reject with TeamGridApiError, including the status, stable error documents, request ID, optional retry delay, and transport metadata. Local validation, routing, timeout, response-size, and pagination failures reject withTeamGridClientError and a stable client error code. Successful envelopes expose non-enumerable transport metadata.
See pagination and errors andclient configuration for handling guidance.