Update an organization member

patch

Authorizations

useroauth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

userIdstringRequired

The unique ID of the User

Body

application/json

rolestring · enum · nullableOptional

The role of a member in an organization, null for guests

Possible values:

Responses

200

The member has been updated

application/json

objectstring · enumRequired

Type of Object, always equals to "member"

Possible values:

idstringRequired

Unique identifier for the user.

rolestring · enum · nullableRequired

The role of a member in an organization, null for guests

Possible values:

disabledbooleanRequired

Whatever the membership of this user is disabled and prevent them from accessing content.

joinedAtstring · date-timeRequired

Date at which the user joined the organization.

lastSeenAtstring · date-timeOptional

Date at which the user was last seen active in the organization.

ssobooleanRequired

Whether the user can login with SSO.

spacesnumberRequired

teamsnumberRequired

sitesnumberRequired

patch/orgs/{organizationId}/members/{userId}

HTTPcURLJavaScriptPython

PATCH /v1/orgs/{organizationId}/members/{userId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "role": "admin"
}

200

The member has been updated

{
  "object": "member",
  "id": "text",
  "role": "admin",
  "user": {
    "object": "user",
    "id": "text",
    "displayName": "text",
    "email": "text",
    "photoURL": "text",
    "urls": {
      "location": "https://example.com"
    }
  },
  "disabled": true,
  "joinedAt": "2026-07-21T22:17:56.396Z",
  "lastSeenAt": "2026-07-21T22:17:56.396Z",
  "sso": true,
  "spaces": 1,
  "teams": 1,
  "sites": 1
}