Skip to main content
PUT
/
scim
/
v2
/
Users
/
{user_id}
{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "userName": "john.doe@example.com",
  "name": {
    "givenName": "John",
    "familyName": "Doe"
  },
  "appRole": "admin",
  "active": true
}

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "id": "3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47",
  "userName": "john.doe@example.com",
  "name": {
    "givenName": "John",
    "familyName": "Doe"
  },
  "emails": [
    {
      "value": "john.doe@example.com",
      "primary": true,
      "type": "work"
    }
  ],
  "appRole": "admin",
  "profileUrl": null,
  "active": true,
  "meta": {
    "resourceType": "User",
    "created": "2024-01-01T00:00:00.000Z",
    "lastModified": "2024-01-02T00:00:00.000Z"
  }
}

​
Authorizations

​
Authorization
string
required
This API uses OAuth 2.0 with the authorization code grant flow.

​
Path

​
user_id
string
required
The workspace membership ID or workspace invite ID of the user to update.

Body

application/json
​
schemas
string[]
required
Must include "urn:ietf:params:scim:schemas:core:2.0:User".
​
userName
string
required
The user’s email address. Must be a valid email.
​
name
object
​
active
boolean
Whether the user should be active. Setting to false suspends the member and revokes their active sessions.
​
appRole
string
The user’s role: "admin" or "member".
​
profileUrl
string
A URL to the user’s avatar. Pass null to clear.

​
Response

Returns 200 with the updated user, or 204 No Content when deprovisioning.
​
schemas
string[]
Always ["urn:ietf:params:scim:schemas:core:2.0:User"].
​
id
string
The workspace membership ID or workspace invite ID.
​
userName
string
The user’s email address.
​
name
object
​
emails
object[]
​
active
boolean
Whether the user is active.
​
appRole
string
The user’s role: "admin" or "member". Not present for suspended users.
​
profileUrl
string
The user’s avatar URL. May be null.
​
meta
object
{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "userName": "john.doe@example.com",
  "name": {
    "givenName": "John",
    "familyName": "Doe"
  },
  "appRole": "admin",
  "active": true
}

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "id": "3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47",
  "userName": "john.doe@example.com",
  "name": {
    "givenName": "John",
    "familyName": "Doe"
  },
  "emails": [
    {
      "value": "john.doe@example.com",
      "primary": true,
      "type": "work"
    }
  ],
  "appRole": "admin",
  "profileUrl": null,
  "active": true,
  "meta": {
    "resourceType": "User",
    "created": "2024-01-01T00:00:00.000Z",
    "lastModified": "2024-01-02T00:00:00.000Z"
  }
}