/{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
|