team_members

Update team member

Re-scope a member: replace permissions and/or account_sids (each in full). A narrowing revokes the member's live sessions in this workspace (the peers follow in five minutes; they sign in again); a widening waits for their next refresh. Inside the caller's own grant (403 insufficient_permission / account_not_allowed). The owner's row patches like any other (ownership moves by transfer_team_ownership). Empty body: 422 nothing_to_update; a value-identical patch is accepted.

Contract:

  • MCP tool update_team_member, registry package mcp.id/team_members, mount id.identity.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/team-members/{sid}

Request

  • Base URL
    https://beta.getsales.io/id/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

Team member (membership or invite) sid (ts_mb_...).

Request body

permissionsstring[]

Full replacement, stored as sent; each token must be held by the caller.

account_sidsstring[] nullable

Full replacement of the slice; null resets to every sender identity. An empty list is refused (422).

Response

update success envelope.

successtrue required
operation'update' required
updated_fieldsstring[] required
previous_valuesobject required
kept_fieldsstring[]

The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.

Changes

No recorded changes to this operation across all 1 revision of this API.