Update a team member of a deal
/deals/{deal_id}/team-members/{id}Changes the fields you send and returns the member. position moves the member and shifts the ones in between, keeping positions contiguous; a position past the end puts the member last. image_id must be a file in the deal's assets folder, else 422 exists. A published deal accepts it. dry_run shows the result without saving it. Emits deal_team_member.updated and sends no email. Sending the previous values undoes it.
Path parameters
The deal's id, a uuid. An unknown deal, or one the token can't see, returns 404.
The team member's id.
Query parameters
Validate and run the call without committing it, returning what the real call would return with
meta.dry_runset.
Request body
application/json, required · DealTeamMemberUpdate
The team member's name.
The team member's job title.
A short biography, up to 500 characters.
The photo: a file in the deal's assets folder. Another file returns 422
exists.The LinkedIn username.
The X (Twitter) username.
Moves the member to this position, from 1. The members in between shift by one, and a position past the end puts the member last.
{
"job_title": "Founding Partner",
"position": 2
}Responses
{
"data": {
"id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
"name": "string",
"job_title": "string",
"bio": "string",
"image_id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
"linkedin_username": "string",
"twitter_username": "string",
"position": 1,
"created_at": "2026-06-12T10:00:00+00:00",
"updated_at": "2026-06-12T10:00:00+00:00"
}
}Authorization failed. error.code is one of org_disabled,
ip_blocked, missing_scope, scope_disabled, user_disabled.
The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per
problem, or a code documented on the operation.
Examples
curl -X PATCH https://your-org-domain/kong/core/api/v2/deals/{deal_id}/team-members/{id}\
-H "Authorization: Bearer $HELM_API_KEY"\
-H "Content-Type: application/json"\
-d '{
"job_title": "Founding Partner",
"position": 2
}'