/{userId}/links
Mount Point: /metadata/v1/{userId}/links/
The following operations are supported on this resource:
GET
Retrieves existing links.
Parameters
name |
description |
type |
default |
userId |
The requested SCIM user ID.
|
path |
|
startIndex |
The index number of the first item to be provided in the results. A null value is equivalent to 0.
|
query |
0 |
count |
The maximum number of items to be provided in the results. A null value signifies no maximum.
|
query |
|
includeUnlinked |
true to include providers that are not currently linked but a link may be added. Unlinked providers will not have a value for the providerUserId field.
|
query |
false |
Response Body
Paged list of links associated with the given user.
Status Codes
code |
description |
200 |
Success
|
POST
Add a new link non-interactively.
Parameters
name |
description |
type |
default |
userId |
The requested SCIM user ID.
|
path |
|
provider |
The External Identity Provider name.
|
query |
|
Request Body
The link to add.
Response Body
Newly added link.
Status Codes
code |
description |
201 |
Success
|
400 |
Bad Request
|
DELETE
Removes an existing link.
Parameters
name |
description |
type |
default |
userId |
The requested SCIM user ID.
|
path |
|
provider |
The External Identity Provider name. Can be null to match all links.
|
query |
|
Status Codes
code |
description |
204 |
Success
|
404 |
No such object
|