members.update_role

Change a member's role in an organization

Request: PATCH/api/v1/organizations/{organizationSlug}/members/{memberId}
Scope required: organization_members:write
Effect: Changes data. Send an Idempotency-Key if you might retry it.
Acts on: Acts on an organization, and names it in the path.
MCP tool: members_update_role
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Moves one member between `owner`, `admin`, `coach` and `applicant`. Owners and admins may call it, but only an owner may promote somebody to owner or change an existing owner, so an admin cannot demote the person who created the organization. Promoting an applicant to staff frees the applicant seat they were using; demoting a staff member to applicant takes one. Read `members.list` first for the `mem_…` id.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
organizationSlug	path	Required	string
memberId	path	Required	string

Request body

role: one of: owner, admin, coach, applicant, required

Response

displayName: string or null, required
email: string, required
id: string, required
joinedAt: string, required
role: one of: owner, admin, coach, applicant, required

Examples

Promote a coach to admin

Promote a coach to admin — request

curl -s -X PATCH https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center/members/mem_41 \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "admin"
}'

Promote a coach to admin — response

{
  "id": "mem_41",
  "email": "coach@northside.example",
  "displayName": "Dana Reyes",
  "role": "admin",
  "joinedAt": "2026-01-06T12:00:00.000Z"
}