Xentree Docs
My Xentree
My Xentree
  1. Organizations
  • Documentation
    • Introduction
    • Quickstart
    • Authentication
    • Conversations
    • Knowledge Base
    • Organizations
    • Profile & Analytics
    • Xentree English
    • Xentree Live
    • Errors and Limits
  • API Reference
    • Authentication
      • Register a new user
      • Log in and get an access token
      • Refresh an access token
      • Log out the current user
      • Get the current authenticated user
      • Update the current authenticated user
    • Conversations
      • List available AI providers
      • Generate an AI response
      • List conversations for the current user
      • Create a conversation
      • Get messages for a conversation
      • Search indexed user content
    • Knowledge Base
      • Search the knowledge base
    • Organizations
      • List organizations for the current user
        GET
      • Create an organization
        POST
      • Get organization details
        GET
      • Update organization details
        PATCH
      • Delete an organization
        DELETE
      • List organization members
        GET
      • Add a member to an organization
        POST
      • Update a member's role
        PATCH
      • Comprehensive member update (role, organization, team)
        PUT
      • Remove a member from an organization
        DELETE
    • Profile & Analytics
      • Get my XP profile
      • Get a user's public profile
      • Get streak status
      • Get weekly XP activity
      • Get learning pulse (365-day heatmap)
      • Get daily quests
      • Get learning time analytics
    • Xentree English
      • List XEL modules with user progress
      • Get XEL module details
      • Submit a learning task response
      • Run AI evaluation for speaking or writing
      • Get the XEL dashboard overview
    • Xentree Live
      • Get remaining Xentree Live quota
      • Start a live session
      • Update an active live session heartbeat
      • End a live session
      • Update the user nickname used in Xentree Live
      • List live transcripts for the current user
      • Save live session transcripts
      • Get a single live transcript
    • Integrations
      • List active integrations for the current user
      • Start the Google Calendar OAuth flow
    • API Keys
      • List API keys
      • Create an API key
      • Delete an API key
  • Schemas
    • Error
    • TokenResponse
    • UserProfile
    • ChatRequest
    • ChatResponse
    • ConversationCreateRequest
    • ConversationResponse
    • KnowledgeSearchRequest
    • LiveStartSessionRequest
    • LiveSessionResponse
    • LiveQuotaResponse
    • TranscriptTurn
    • SaveLiveTranscriptsRequest
    • OrganizationCreateRequest
    • OrganizationResponse
    • MemberResponse
    • XELModuleSummary
    • XELTaskSubmissionRequest
    • APIKeyCreateRequest
    • XPProfileResponse
    • APIKeyResponse
    • PublicXPProfileResponse
    • StreakStatusResponse
    • WeeklyActivityResponse
    • LearningPulseDayEntry
    • LearningPulseResponse
    • QuestItem
    • QuestsResponse
    • LearningTimeAnalyticsResponse
  1. Organizations

Update a member's role

PATCH
/api/organizations/{org_id}/members/{target_user_id}
Update the role of an existing member.
Only organization administrators can update roles.
An administrator cannot change another administrator's role.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Member role updated.
Body

🟠403
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://my.xentree.com/api/organizations//members/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "role": "team_manager"
}'
Response Response Example
{
    "user_id": "string",
    "username": "string",
    "email": "string",
    "full_name": "string",
    "role": "string",
    "joined_at": "string",
    "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",
    "team_name": "string"
}
Modified at 2026-04-23 07:01:35
Previous
Add a member to an organization
Next
Comprehensive member update (role, organization, team)
Built with