Authentication
All API-requests are protected with a long-lived bearer-token.
This token can be generated through the UserSync-WebApp
Fetching a single user
Text goes here
Search for a user
Text goes here
Adding a user
Endpoint | Method |
|---|---|
| POST |
Request-object:
{
"externalId": "<unique-identifier-in-source-system>",
"userName": "<unique-email>",
"active": <true|false>,
"name": {
"familyName": "<lastname>",
"givenName": "<firstname>"
},
"roles": [
{
"value": "<talentech-group-identifier>"
},
{
"value": "<talentech-group-identifier>"
}
]
}
Property | Type | Required | |
|---|---|---|---|
| string | Yes | Id of entity in remote system. |
| string | Yes | Username for user. |
| boolean | No | Activationstatus for account. |
| string | No | Lastname |
| string | No | Firstname |
| array | No | Should contain atleast 1 role in order to propegate provisioning of the user to applications |
Sample-Request:
curl --location --request POST 'https://[API-URL]/scim/Users' \
--header 'Authorization: Bearer [AUTH-TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
"externalId": "16861ac5-deaa-4d66-a4cc-bc788965cc37",
"userName": "username@domain.com",
"active": true,
"name": {
"familyName": "Doe",
"givenName": "John"
},
"roles": [
{
"value": "TalentechGroupTest1"
},
{
"value": "TalentechGroupTest2"
}
]
}'
Responses:
User registered - Http-Statuscode: 201 | |
|---|---|
Statuscode | 201 |
Response-body: {
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {},
"active": true,
"meta": {
"resourceType": "User"
},
"name": {
"familyName": "Doe",
"givenName": "John"
},
"roles": [
{
"value": "TalentechGroupTest1",
"type": null,
"primary": false
},
{
"value": "TalentechGroupTest2",
"type": null,
"primary": false
}
],
"userName": "username@domain.com",
"externalId": "26861ac5-deaa-4d66-a4cc-bc788965cc37",
"id": "a3792aca-8f99-4d4b-a1f2-2b31e871b634",
"schemas": []
}
| |
Statuscode | ||
|---|---|---|
201-OK | ||
409-Conflict | There is allready a User registered with one or more property-values requiring uniqeness |
Modifying/Updating properties of a user or their Roles
Text goes here
Deactivating a user (Soft-delete)
Text goes here
Deleting a user (Hard delete)
Text goes here