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
}
]
}
'{
"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"
}
}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)
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
}
]
}
'{
"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"
}
}Authorizations
OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as Authorization: Bearer <token>.
Path Parameters
The user's SCIM resource ID.
Body
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?