Patch User

Patch User

This endpoint is responsible for pathing a user. For more information, check the specification: https://tools.ietf.org/html/rfc7644#section-3.5.2.

Request
URI
PATCH
https://{api_host}/usergroup/t/{tenant}/scim/v2/Users/{id}
COPY
Path Parameters
string
id
Required

The ID of the user

string
tenant
Required

The VMware Identity Services tenant ID

tenant example
my-tenant

Request Body
PatchRequestMedia of type(s) application/scim+json
Required

Show optional properties

{
    "Operations": [
        {
            "op": "add"
        }
    ]
}
{
    "Operations": [
        {
            "value": "India",
            "path": "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:country",
            "op": "add"
        }
    ],
    "id": "string",
    "externalId": "string",
    "meta": {
        "location": "string",
        "version": "string",
        "lastModified": "string",
        "resourceType": "string",
        "created": "string"
    },
    "schemas": [
        "string"
    ]
}
array of object
Operations
Required

Operations for SCIM 2 patch request

string
id
Optional

The unique identifier of the SCIM resource

string
externalId
Optional

The SCIM resource external identifier

object
meta
Optional

The meta information of the resource

array of string
schemas
Optional

The SCIM resource schema URIs

Authentication
This operation uses the following authentication methods.
Responses
200

The user was successfully updated.

Returns UserMedia of type(s) application/scim+json
"UserMedia Object"
object
name
Optional

The name of the user

string
displayName
Optional

The name of the user, suitable for display to end-users

string
nickName
Optional

The casual way to address the user

string As uri As uri
profileUrl
Optional

A fully qualified URL to a page representing the user's online profile

boolean
active
Optional

A Boolean value indicating the user's administrative status

array of object
emails
Optional

The list of emails associated with the user

array of object
phoneNumbers
Optional

The phone numbers for the user

array of object
ims
Optional

The instant messaging addresses for the user

array of object
photos
Optional

The URIs of photos of the user

array of object
addresses
Optional

The physical mailing addresses for this user

string
userName
Required

The unique identifier of the user

array of object
groups
Optional

The list of groups that the user belongs to

string
title
Optional

The title of the user

string
id
Optional

The unique identifier of the SCIM resource

string
externalId
Optional

The SCIM resource external identifier

object
meta
Optional

The meta information of the resource

array of string
schemas
Optional

The SCIM resource schema URIs


400

The request contains invalid information.

Operation doesn't return any data structure

404

The user was not found.

Operation doesn't return any data structure

409

The specified version number does not match the resource's latest version number, or a service provider refused to create a new, duplicate resource.

Operation doesn't return any data structure

500

Unexpected error.

Operation doesn't return any data structure

Code Samples
COPY
                    curl -X PATCH -H 'Authorization: <value>' -H 'Content-Type: application/scim+json' -d '{"Operations":["object"]}'