Update Team Member

PATCH

/team-members/{team_member_id}

• Production
• QA

Edit somebody else’s roster record. Omitted fields are left alone.

Authorizations

• BearerAuth

Parameters

Path Parameters

team_member_id

required

Team member id.

string

Team member id.

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

Mirrors team_members.TeamMemberUpdateRequest, field for field.

Every field is optional and an omitted field is LEFT ALONE - this is a PATCH, not a replacement.

object

achievements

Any of:

Array<string>

Array<string>

null

null

avatar_url

Any of:

string

string

null

null

bio_full

Any of:

string

string

null

null

bio_short

Any of:

string

string

null

null

certifications

Any of:

Array<string>

Array<string>

null

null

company

Any of:

string

string

<= 255 characters

null

null

custom_notes

Any of:

string

string

null

null

department

Any of:

string

string

<= 100 characters

null

null

expertise_areas

Any of:

Array<string>

Array<string>

null

null

languages

Any of:

Array<string>

Array<string>

null

null

linkedin_url

Any of:

string

string

null

null

name

Any of:

string

string

>= 1 characters <= 255 characters

null

null

personal_interests

Any of:

Array<string>

Array<string>

null

null

personal_website

Any of:

string

string

null

null

phone

Any of:

string

string

<= 50 characters

null

null

preferences

Any of:

object

object

key

additional properties

any

null

null

responsibilities

Any of:

string

string

null

null

timezone

Any of:

string

string

<= 100 characters

null

null

title

Any of:

string

string

<= 255 characters

null

null

tools_platforms

Any of:

Array<string>

Array<string>

null

null

topics_of_interest

Any of:

Array<string>

Array<string>

null

null

twitter_url

Any of:

string

string

null

null

voice_tone

Any of:

string

string

<= 50 characters

null

null

Responses

200

Successful Response

object

data

required

An open envelope for a single role, team, member or account record.

Open on purpose. The app’s own response models on this surface grow with the product - RoleResponse gained rep_limits and manages_role_slugs, TeamResponse gained channel counts and a campaign count - and a pinned mirror would SILENTLY DROP whatever it had not caught up on. A dropped permission in a role read is the worst possible kind of stale: it reads as “they do not have it”.

object

key

additional properties

any

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string