Update a user
curl --request PATCH \
--url https://app.trelica.com/api/scim/v2/Users/{userId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/scim+json' \
--data '
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"path": "title",
"value": "Senior Customer Success Manager"
},
{
"op": "replace",
"path": "name.givenName",
"value": "Jonathan"
},
{
"op": "replace",
"path": "active",
"value": false
}
]
}
'const url = 'https://app.trelica.com/api/scim/v2/Users/{userId}';
const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/scim+json'},
body: JSON.stringify({
schemas: ['urn:ietf:params:scim:api:messages:2.0:PatchOp'],
Operations: [
{op: 'replace', path: 'title', value: 'Senior Customer Success Manager'},
{op: 'replace', path: 'name.givenName', value: 'Jonathan'},
{op: 'replace', path: 'active', value: false}
]
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://app.trelica.com/api/scim/v2/Users/{userId}"
payload = {
"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations": [
{
"op": "replace",
"path": "title",
"value": "Senior Customer Success Manager"
},
{
"op": "replace",
"path": "name.givenName",
"value": "Jonathan"
},
{
"op": "replace",
"path": "active",
"value": False
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/scim+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.trelica.com/api/scim/v2/Users/{userId}"
payload := strings.NewReader("{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/scim+json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/scim/v2/Users/{userId}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}", false);
var response = await client.PatchAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.patch("https://app.trelica.com/api/scim/v2/Users/{userId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/scim+json")
.body("{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trelica.com/api/scim/v2/Users/{userId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'schemas' => [
'urn:ietf:params:scim:api:messages:2.0:PatchOp'
],
'Operations' => [
[
'op' => 'replace',
'path' => 'title',
'value' => 'Senior Customer Success Manager'
],
[
'op' => 'replace',
'path' => 'name.givenName',
'value' => 'Jonathan'
],
[
'op' => 'replace',
'path' => 'active',
'value' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/scim+json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/scim+json")
$response = Invoke-WebRequest -Uri 'https://app.trelica.com/api/scim/v2/Users/{userId}' -Method PATCH -Headers $headers -ContentType 'application/scim+json' -Body '{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"path": "title",
"value": "Senior Customer Success Manager"
},
{
"op": "replace",
"path": "name.givenName",
"value": "Jonathan"
},
{
"op": "replace",
"path": "active",
"value": false
}
]
}'require 'uri'
require 'net/http'
url = URI("https://app.trelica.com/api/scim/v2/Users/{userId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/scim+json'
request.body = "{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"userName": "erika.mustermann@example.com",
"name": {
"formatted": "Erika Mustermann",
"familyName": "Mustermann",
"givenName": "Erika"
},
"displayName": "Erika Mustermann",
"title": "Customer Success Manager",
"preferredLanguage": "en-GB",
"locale": "en-GB",
"active": true,
"emails": [
{
"primary": true,
"type": "work",
"value": "erika.mustermann@example.com"
}
],
"roles": [
{
"value": "Admin",
"display": "Admin",
"primary": false
}
],
"id": "8089ac9b31841227d4aee4f0adecd81f",
"meta": {
"created": "2019-01-01T00:00:00Z",
"lastModified": "2024-12-06T14:58:12Z",
"resourceType": "User"
}
}{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}{
"type": "about:blank",
"title": "Not found.",
"status": 404,
"detail": "The requested resource does not exist or you do not have access to it.",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}SCIM
Update a user
Applies a SCIM PATCH operation set to a user, following the SCIM 2.0 protocol (RFC 7644).
The request body must use the SCIM PatchOp schema
(urn:ietf:params:scim:api:messages:2.0:PatchOp) and supply one or more add/replace/
remove operations, each with a path. userName is immutable. EPM-managed and
system-managed users cannot be modified (403).
Required scope: Users.Write (Write access to users with access to SaaS Manager)
PATCH
/
api
/
scim
/
v2
/
Users
/
{userId}
Update a user
curl --request PATCH \
--url https://app.trelica.com/api/scim/v2/Users/{userId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/scim+json' \
--data '
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"path": "title",
"value": "Senior Customer Success Manager"
},
{
"op": "replace",
"path": "name.givenName",
"value": "Jonathan"
},
{
"op": "replace",
"path": "active",
"value": false
}
]
}
'const url = 'https://app.trelica.com/api/scim/v2/Users/{userId}';
const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/scim+json'},
body: JSON.stringify({
schemas: ['urn:ietf:params:scim:api:messages:2.0:PatchOp'],
Operations: [
{op: 'replace', path: 'title', value: 'Senior Customer Success Manager'},
{op: 'replace', path: 'name.givenName', value: 'Jonathan'},
{op: 'replace', path: 'active', value: false}
]
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://app.trelica.com/api/scim/v2/Users/{userId}"
payload = {
"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations": [
{
"op": "replace",
"path": "title",
"value": "Senior Customer Success Manager"
},
{
"op": "replace",
"path": "name.givenName",
"value": "Jonathan"
},
{
"op": "replace",
"path": "active",
"value": False
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/scim+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.trelica.com/api/scim/v2/Users/{userId}"
payload := strings.NewReader("{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/scim+json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/scim/v2/Users/{userId}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}", false);
var response = await client.PatchAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.patch("https://app.trelica.com/api/scim/v2/Users/{userId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/scim+json")
.body("{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trelica.com/api/scim/v2/Users/{userId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'schemas' => [
'urn:ietf:params:scim:api:messages:2.0:PatchOp'
],
'Operations' => [
[
'op' => 'replace',
'path' => 'title',
'value' => 'Senior Customer Success Manager'
],
[
'op' => 'replace',
'path' => 'name.givenName',
'value' => 'Jonathan'
],
[
'op' => 'replace',
'path' => 'active',
'value' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/scim+json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/scim+json")
$response = Invoke-WebRequest -Uri 'https://app.trelica.com/api/scim/v2/Users/{userId}' -Method PATCH -Headers $headers -ContentType 'application/scim+json' -Body '{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"path": "title",
"value": "Senior Customer Success Manager"
},
{
"op": "replace",
"path": "name.givenName",
"value": "Jonathan"
},
{
"op": "replace",
"path": "active",
"value": false
}
]
}'require 'uri'
require 'net/http'
url = URI("https://app.trelica.com/api/scim/v2/Users/{userId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/scim+json'
request.body = "{\n \"schemas\": [\n \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n ],\n \"Operations\": [\n {\n \"op\": \"replace\",\n \"path\": \"title\",\n \"value\": \"Senior Customer Success Manager\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"name.givenName\",\n \"value\": \"Jonathan\"\n },\n {\n \"op\": \"replace\",\n \"path\": \"active\",\n \"value\": false\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"userName": "erika.mustermann@example.com",
"name": {
"formatted": "Erika Mustermann",
"familyName": "Mustermann",
"givenName": "Erika"
},
"displayName": "Erika Mustermann",
"title": "Customer Success Manager",
"preferredLanguage": "en-GB",
"locale": "en-GB",
"active": true,
"emails": [
{
"primary": true,
"type": "work",
"value": "erika.mustermann@example.com"
}
],
"roles": [
{
"value": "Admin",
"display": "Admin",
"primary": false
}
],
"id": "8089ac9b31841227d4aee4f0adecd81f",
"meta": {
"created": "2019-01-01T00:00:00Z",
"lastModified": "2024-12-06T14:58:12Z",
"resourceType": "User"
}
}{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}{
"type": "about:blank",
"title": "Not found.",
"status": 404,
"detail": "The requested resource does not exist or you do not have access to it.",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}Authorizations
OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as Authorization: Bearer <token>.
Scopes
Users.Write
Write access to users with access to SaaS Manager
Path Parameters
The user's SCIM resource ID.
Body
application/scim+json
Response
OK
Unique identifier for the user, typically their email address. Required; must belong to a domain verified for your organization. Immutable once set.
The components of the user's name.
Show child attributes
Show child attributes
The user's display name (derived from their name on output). Server-controlled.
The user's job title, e.g. "Vice President".
The user's preferred language; mirrors locale on output. Set locale instead.
The user's default locale, e.g. "en-US", used for localizing currency, dates and numbers.
The user's time zone in IANA ("Olson") format, e.g. "America/Los_Angeles".
Whether the user is active. false suspends the user's SaaS Manager access.
Email addresses for the user.
Show child attributes
Show child attributes
Phone numbers for the user. Only the first value is stored.
Show child attributes
Show child attributes
The SaaS Manager roles assigned to the user. Each role's value must match an existing role name.
Show child attributes
Show child attributes
The service-provider-assigned SCIM resource ID. Server-controlled; ignored on requests.
An identifier for the resource as defined by the provisioning client.
Resource metadata (created/last-modified timestamps, resource type, location). Server-controlled; ignored on requests.
Show child attributes
Show child attributes
Was this page helpful?