Change a member's role

PUT 
/api/v1/organizations/members/:user_id

Promote or demote an existing organization member.

• Owner can change admin/manager/member roles (ownership transfers use POST /current/transfer-ownership).
• Admin can promote/demote between member and manager.
• The owner's role is never editable via this endpoint (400/403).
• 400 if data.org_role == "owner" (use the transfer endpoint).
• API-key scope required: members:change_role.

Request

Responses

200

Successful Response

400

Bad request — malformed input or failed validation.

401

Missing, expired, or invalid credentials.

403

Authenticated but not authorized for this resource. Note: cross-organization reads return 404, not 403.

404

Resource not found, or hidden for tenant-enumeration safety (the caller lacks permission to know whether the resource exists).

409

Conflict — the current resource state does not allow this operation (e.g. assessment already started, email already in use).

422

Semantic validation failure — request shape was valid but contents were not.

429

Too many requests — rate limited. Retry after the window resets.

500

Internal server error — unexpected failure.