---
title: SCIMApi
---
## PureCloud::SCIMApi
All URIs are relative to *https://api.mypurecloud.com*
Method | Description
------------- | ------------- | -------------
[**delete_scim_user**](SCIMApi.html#delete_scim_user) | Delete a user
[**delete_scim_v2_user**](SCIMApi.html#delete_scim_v2_user) | Delete a user
[**get_scim_group**](SCIMApi.html#get_scim_group) | Get a group
[**get_scim_groups**](SCIMApi.html#get_scim_groups) | Get a list of groups
[**get_scim_resourcetype**](SCIMApi.html#get_scim_resourcetype) | Get a resource type
[**get_scim_resourcetypes**](SCIMApi.html#get_scim_resourcetypes) | Get a list of resource types
[**get_scim_serviceproviderconfig**](SCIMApi.html#get_scim_serviceproviderconfig) | Get a service provider's configuration
[**get_scim_user**](SCIMApi.html#get_scim_user) | Get a user
[**get_scim_users**](SCIMApi.html#get_scim_users) | Get a list of users
[**get_scim_v2_group**](SCIMApi.html#get_scim_v2_group) | Get a group
[**get_scim_v2_groups**](SCIMApi.html#get_scim_v2_groups) | Get a list of groups
[**get_scim_v2_resourcetype**](SCIMApi.html#get_scim_v2_resourcetype) | Get a resource type
[**get_scim_v2_resourcetypes**](SCIMApi.html#get_scim_v2_resourcetypes) | Get a list of resource types
[**get_scim_v2_serviceproviderconfig**](SCIMApi.html#get_scim_v2_serviceproviderconfig) | Get a service provider's configuration
[**get_scim_v2_user**](SCIMApi.html#get_scim_v2_user) | Get a user
[**get_scim_v2_users**](SCIMApi.html#get_scim_v2_users) | Get a list of users
[**patch_scim_group**](SCIMApi.html#patch_scim_group) | Modify a group
[**patch_scim_user**](SCIMApi.html#patch_scim_user) | Modify a user
[**patch_scim_v2_group**](SCIMApi.html#patch_scim_v2_group) | Modify a group
[**patch_scim_v2_user**](SCIMApi.html#patch_scim_v2_user) | Modify a user
[**post_scim_users**](SCIMApi.html#post_scim_users) | Create a user
[**post_scim_v2_users**](SCIMApi.html#post_scim_v2_users) | Create a user
[**put_scim_group**](SCIMApi.html#put_scim_group) | Replace a group
[**put_scim_user**](SCIMApi.html#put_scim_user) | Replace a user
[**put_scim_v2_group**](SCIMApi.html#put_scim_v2_group) | Replace a group
[**put_scim_v2_user**](SCIMApi.html#put_scim_v2_user) | Replace a user
{: class="table table-striped"}
## [**Empty**](Empty.html) delete_scim_user(user_id, opts)
Delete a user
Wraps DELETE /api/v2/scim/users/{userId}
Requires ANY permissions:
* directory:user:delete
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/users.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Delete a user
result = api_instance.delete_scim_user(user_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->delete_scim_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/users. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**Empty**](Empty.html) delete_scim_v2_user(user_id, opts)
Delete a user
Wraps DELETE /api/v2/scim/v2/users/{userId}
Requires ANY permissions:
* directory:user:delete
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/v2/users.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Delete a user
result = api_instance.delete_scim_v2_user(user_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->delete_scim_v2_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/v2/users. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2Group**](ScimV2Group.html) get_scim_group(group_id, opts)
Get a group
Wraps GET /api/v2/scim/groups/{groupId}
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
group_id = "group_id_example" # String | The ID of a group. Returned with GET /api/v2/scim/groups.
opts = {
if_none_match: "if_none_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified.
}
begin
#Get a group
result = api_instance.get_scim_group(group_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_group: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**group_id** | **String**| The ID of a group. Returned with GET /api/v2/scim/groups. | |
**if_none_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified. | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2Group**](ScimV2Group.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimGroupListResponse**](ScimGroupListResponse.html) get_scim_groups(opts)
Get a list of groups
Wraps GET /api/v2/scim/groups
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
opts = {
start_index: 1, # Integer | The 1-based index of the first query result.
count: 25, # Integer | The requested number of items per page. A value of 0 returns \"totalResults\".
filter: "displayName eq groupName" # String | Filters results.
}
begin
#Get a list of groups
result = api_instance.get_scim_groups(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_groups: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**start_index** | **Integer**| The 1-based index of the first query result. | [optional] [default to 1] |
**count** | **Integer**| The requested number of items per page. A value of 0 returns \"totalResults\". | [optional] [default to 25] |
**filter** | **String**| Filters results. | [optional] |
{: class="table table-striped"}
### Return type
[**ScimGroupListResponse**](ScimGroupListResponse.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimConfigResourceType**](ScimConfigResourceType.html) get_scim_resourcetype(resource_type)
Get a resource type
Wraps GET /api/v2/scim/resourcetypes/{resourceType}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
api_instance = PureCloud::SCIMApi.new
resource_type = "resource_type_example" # String | The type of resource. Returned with GET /api/v2/scim/resourcetypes.
begin
#Get a resource type
result = api_instance.get_scim_resourcetype(resource_type)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_resourcetype: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**resource_type** | **String**| The type of resource. Returned with GET /api/v2/scim/resourcetypes. |
**Values**: User, Group, ServiceProviderConfig, ResourceType |
{: class="table table-striped"}
### Return type
[**ScimConfigResourceType**](ScimConfigResourceType.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimConfigResourceTypesListResponse**](ScimConfigResourceTypesListResponse.html) get_scim_resourcetypes
Get a list of resource types
Wraps GET /api/v2/scim/resourcetypes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
api_instance = PureCloud::SCIMApi.new
begin
#Get a list of resource types
result = api_instance.get_scim_resourcetypes
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_resourcetypes: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**ScimConfigResourceTypesListResponse**](ScimConfigResourceTypesListResponse.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimServiceProviderConfig**](ScimServiceProviderConfig.html) get_scim_serviceproviderconfig(opts)
Get a service provider's configuration
Wraps GET /api/v2/scim/serviceproviderconfig
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
api_instance = PureCloud::SCIMApi.new
opts = {
if_none_match: "if_none_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/serviceproviderconfig. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified.
}
begin
#Get a service provider's configuration
result = api_instance.get_scim_serviceproviderconfig(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_serviceproviderconfig: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**if_none_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/serviceproviderconfig. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified. | [optional] |
{: class="table table-striped"}
### Return type
[**ScimServiceProviderConfig**](ScimServiceProviderConfig.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) get_scim_user(user_id, opts)
Get a user
Wraps GET /api/v2/scim/users/{userId}
Requires ANY permissions:
* directory:user:view
* directory:user:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/users.
opts = {
if_none_match: "if_none_match_example" # String | TThe ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified.
}
begin
#Get a user
result = api_instance.get_scim_user(user_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/users. | |
**if_none_match** | **String**| TThe ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified. | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimUserListResponse**](ScimUserListResponse.html) get_scim_users(filter, opts)
Get a list of users
Wraps GET /api/v2/scim/users
Requires ANY permissions:
* directory:user:view
* directory:user:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
filter = "filter_example" # String | Filters results.
opts = {
start_index: 1, # Integer | The 1-based index of the first query result.
count: 25 # Integer | The requested number of items per page. A value of 0 returns \"totalResults\".
}
begin
#Get a list of users
result = api_instance.get_scim_users(filter, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_users: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**filter** | **String**| Filters results. | |
**start_index** | **Integer**| The 1-based index of the first query result. | [optional] [default to 1] |
**count** | **Integer**| The requested number of items per page. A value of 0 returns \"totalResults\". | [optional] [default to 25] |
{: class="table table-striped"}
### Return type
[**ScimUserListResponse**](ScimUserListResponse.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2Group**](ScimV2Group.html) get_scim_v2_group(group_id, opts)
Get a group
Wraps GET /api/v2/scim/v2/groups/{groupId}
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
group_id = "group_id_example" # String | The ID of a group. Returned with GET /api/v2/scim/v2/groups.
opts = {
if_none_match: "if_none_match_example" # String | TThe ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified.
}
begin
#Get a group
result = api_instance.get_scim_v2_group(group_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_v2_group: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**group_id** | **String**| The ID of a group. Returned with GET /api/v2/scim/v2/groups. | |
**if_none_match** | **String**| TThe ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified. | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2Group**](ScimV2Group.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimGroupListResponse**](ScimGroupListResponse.html) get_scim_v2_groups(filter, opts)
Get a list of groups
Wraps GET /api/v2/scim/v2/groups
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
filter = "displayName eq groupName" # String | Filters results.
opts = {
start_index: 1, # Integer | The 1-based index of the first query result.
count: 25 # Integer | The requested number of items per page. A value of 0 returns \"totalResults\".
}
begin
#Get a list of groups
result = api_instance.get_scim_v2_groups(filter, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_v2_groups: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**filter** | **String**| Filters results. | |
**start_index** | **Integer**| The 1-based index of the first query result. | [optional] [default to 1] |
**count** | **Integer**| The requested number of items per page. A value of 0 returns \"totalResults\". | [optional] [default to 25] |
{: class="table table-striped"}
### Return type
[**ScimGroupListResponse**](ScimGroupListResponse.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimConfigResourceType**](ScimConfigResourceType.html) get_scim_v2_resourcetype(resource_type)
Get a resource type
Wraps GET /api/v2/scim/v2/resourcetypes/{resourceType}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
api_instance = PureCloud::SCIMApi.new
resource_type = "resource_type_example" # String | The type of resource. Returned with GET /api/v2/scim/v2/resourcetypes.
begin
#Get a resource type
result = api_instance.get_scim_v2_resourcetype(resource_type)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_v2_resourcetype: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**resource_type** | **String**| The type of resource. Returned with GET /api/v2/scim/v2/resourcetypes. |
**Values**: User, Group, ServiceProviderConfig, ResourceType |
{: class="table table-striped"}
### Return type
[**ScimConfigResourceType**](ScimConfigResourceType.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimConfigResourceTypesListResponse**](ScimConfigResourceTypesListResponse.html) get_scim_v2_resourcetypes
Get a list of resource types
Wraps GET /api/v2/scim/v2/resourcetypes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
api_instance = PureCloud::SCIMApi.new
begin
#Get a list of resource types
result = api_instance.get_scim_v2_resourcetypes
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_v2_resourcetypes: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**ScimConfigResourceTypesListResponse**](ScimConfigResourceTypesListResponse.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimServiceProviderConfig**](ScimServiceProviderConfig.html) get_scim_v2_serviceproviderconfig(opts)
Get a service provider's configuration
Wraps GET /api/v2/scim/v2/serviceproviderconfig
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
api_instance = PureCloud::SCIMApi.new
opts = {
if_none_match: "if_none_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/serviceproviderconfig. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified.
}
begin
#Get a service provider's configuration
result = api_instance.get_scim_v2_serviceproviderconfig(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_v2_serviceproviderconfig: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**if_none_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/serviceproviderconfig. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified. | [optional] |
{: class="table table-striped"}
### Return type
[**ScimServiceProviderConfig**](ScimServiceProviderConfig.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) get_scim_v2_user(user_id, opts)
Get a user
Wraps GET /api/v2/scim/v2/users/{userId}
Requires ANY permissions:
* directory:user:view
* directory:user:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/v2/users.
opts = {
if_none_match: "if_none_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified.
}
begin
#Get a user
result = api_instance.get_scim_v2_user(user_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_v2_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/v2/users. | |
**if_none_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns the current configuration of the resource. If the ETag is current, returns 304 Not Modified. | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimUserListResponse**](ScimUserListResponse.html) get_scim_v2_users(filter, opts)
Get a list of users
Wraps GET /api/v2/scim/v2/users
Requires ANY permissions:
* directory:user:view
* directory:user:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
filter = "filter_example" # String | Filters results.
opts = {
start_index: 1, # Integer | The 1-based index of the first query result.
count: 25 # Integer | The requested number of items per page. A value of 0 returns \"totalResults\".
}
begin
#Get a list of users
result = api_instance.get_scim_v2_users(filter, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->get_scim_v2_users: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**filter** | **String**| Filters results. | |
**start_index** | **Integer**| The 1-based index of the first query result. | [optional] [default to 1] |
**count** | **Integer**| The requested number of items per page. A value of 0 returns \"totalResults\". | [optional] [default to 25] |
{: class="table table-striped"}
### Return type
[**ScimUserListResponse**](ScimUserListResponse.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2Group**](ScimV2Group.html) patch_scim_group(group_id, body, opts)
Modify a group
Wraps PATCH /api/v2/scim/groups/{groupId}
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
group_id = "group_id_example" # String | The ID of a group. Returned with GET /api/v2/scim/groups.
body = PureCloud::ScimV2PatchRequest.new # ScimV2PatchRequest | The information used to modify a group.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Modify a group
result = api_instance.patch_scim_group(group_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->patch_scim_group: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**group_id** | **String**| The ID of a group. Returned with GET /api/v2/scim/groups. | |
**body** | [**ScimV2PatchRequest**](ScimV2PatchRequest.html)| The information used to modify a group. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2Group**](ScimV2Group.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) patch_scim_user(user_id, body, opts)
Modify a user
Wraps PATCH /api/v2/scim/users/{userId}
Requires ANY permissions:
* directory:user:edit
* directory:user:setPassword
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/users.
body = PureCloud::ScimV2PatchRequest.new # ScimV2PatchRequest | The information used to modify a user.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Modify a user
result = api_instance.patch_scim_user(user_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->patch_scim_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/users. | |
**body** | [**ScimV2PatchRequest**](ScimV2PatchRequest.html)| The information used to modify a user. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2Group**](ScimV2Group.html) patch_scim_v2_group(group_id, body, opts)
Modify a group
Wraps PATCH /api/v2/scim/v2/groups/{groupId}
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
group_id = "group_id_example" # String | The ID of a group. Returned with GET /api/v2/scim/v2/groups.
body = PureCloud::ScimV2PatchRequest.new # ScimV2PatchRequest | The information used to modify a group.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Modify a group
result = api_instance.patch_scim_v2_group(group_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->patch_scim_v2_group: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**group_id** | **String**| The ID of a group. Returned with GET /api/v2/scim/v2/groups. | |
**body** | [**ScimV2PatchRequest**](ScimV2PatchRequest.html)| The information used to modify a group. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2Group**](ScimV2Group.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) patch_scim_v2_user(user_id, body, opts)
Modify a user
Wraps PATCH /api/v2/scim/v2/users/{userId}
Requires ANY permissions:
* directory:user:edit
* directory:user:setPassword
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/v2/users.
body = PureCloud::ScimV2PatchRequest.new # ScimV2PatchRequest | The information used to modify a user.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Modify a user
result = api_instance.patch_scim_v2_user(user_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->patch_scim_v2_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/v2/users. | |
**body** | [**ScimV2PatchRequest**](ScimV2PatchRequest.html)| The information used to modify a user. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) post_scim_users(body)
Create a user
Wraps POST /api/v2/scim/users
Requires ANY permissions:
* directory:user:add
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
body = PureCloud::ScimV2CreateUser.new # ScimV2CreateUser | The information used to create a user.
begin
#Create a user
result = api_instance.post_scim_users(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->post_scim_users: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**ScimV2CreateUser**](ScimV2CreateUser.html)| The information used to create a user. | |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) post_scim_v2_users(body)
Create a user
Wraps POST /api/v2/scim/v2/users
Requires ANY permissions:
* directory:user:add
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
body = PureCloud::ScimV2CreateUser.new # ScimV2CreateUser | The information used to create a user.
begin
#Create a user
result = api_instance.post_scim_v2_users(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->post_scim_v2_users: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**ScimV2CreateUser**](ScimV2CreateUser.html)| The information used to create a user. | |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2Group**](ScimV2Group.html) put_scim_group(group_id, body, opts)
Replace a group
Wraps PUT /api/v2/scim/groups/{groupId}
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
group_id = "group_id_example" # String | The ID of a group. Returned with GET /api/v2/scim/groups.
body = PureCloud::ScimV2Group.new # ScimV2Group | The information used to replace a group.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Replace a group
result = api_instance.put_scim_group(group_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->put_scim_group: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**group_id** | **String**| The ID of a group. Returned with GET /api/v2/scim/groups. | |
**body** | [**ScimV2Group**](ScimV2Group.html)| The information used to replace a group. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2Group**](ScimV2Group.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) put_scim_user(user_id, body, opts)
Replace a user
Wraps PUT /api/v2/scim/users/{userId}
Requires ANY permissions:
* directory:user:edit
* directory:user:setPassword
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/users.
body = PureCloud::ScimV2User.new # ScimV2User | The information used to replace a user.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Replace a user
result = api_instance.put_scim_user(user_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->put_scim_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/users. | |
**body** | [**ScimV2User**](ScimV2User.html)| The information used to replace a user. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2Group**](ScimV2Group.html) put_scim_v2_group(group_id, body, opts)
Replace a group
Wraps PUT /api/v2/scim/v2/groups/{groupId}
Requires ANY permissions:
* directory:group:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
group_id = "group_id_example" # String | The ID of a group. Returned with GET /api/v2/scim/v2/groups.
body = PureCloud::ScimV2Group.new # ScimV2Group | The information used to replace a group.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Replace a group
result = api_instance.put_scim_v2_group(group_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->put_scim_v2_group: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**group_id** | **String**| The ID of a group. Returned with GET /api/v2/scim/v2/groups. | |
**body** | [**ScimV2Group**](ScimV2Group.html)| The information used to replace a group. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/groups/{groupId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2Group**](ScimV2Group.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json
## [**ScimV2User**](ScimV2User.html) put_scim_v2_user(user_id, body, opts)
Replace a user
Wraps PUT /api/v2/scim/v2/users/{userId}
Requires ANY permissions:
* directory:user:edit
* directory:user:setPassword
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::SCIMApi.new
user_id = "user_id_example" # String | The ID of a user. Returned with GET /api/v2/scim/v2/users.
body = PureCloud::ScimV2User.new # ScimV2User | The information used to replace a user.
opts = {
if_match: "if_match_example" # String | The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\".
}
begin
#Replace a user
result = api_instance.put_scim_v2_user(user_id, body, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling SCIMApi->put_scim_v2_user: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**user_id** | **String**| The ID of a user. Returned with GET /api/v2/scim/v2/users. | |
**body** | [**ScimV2User**](ScimV2User.html)| The information used to replace a user. | |
**if_match** | **String**| The ETag of a resource in double quotes. Returned as header and meta.version with initial call to GET /api/v2/scim/v2/users/{userId}. Example: \"42\". If the ETag is different from the version on the server, returns 400 with a \"scimType\" of \"invalidVers\". | [optional] |
{: class="table table-striped"}
### Return type
[**ScimV2User**](ScimV2User.html)
### HTTP request headers
- **Content-Type**: application/json, application/scim+json
- **Accept**: application/json, application/scim+json