---
title: QualityApi
---
## PureCloud::QualityApi
All URIs are relative to *https://api.mypurecloud.com*
Method | HTTP request | Description
------------- | ------------- | -------------
|[**delete_calibrations_calibration_id**](QualityApi.html#delete_calibrations_calibration_id) | **DELETE** /api/v2/quality/calibrations/{calibrationId} | Delete a calibration by id.|
|[**delete_conversations_conversation_id_evaluations_evaluation_id**](QualityApi.html#delete_conversations_conversation_id_evaluations_evaluation_id) | **DELETE** /api/v2/quality/conversations/{conversationId}/evaluations/{evaluationId} | Delete an evaluation|
|[**delete_forms_form_id**](QualityApi.html#delete_forms_form_id) | **DELETE** /api/v2/quality/forms/{formId} | Delete an evaluation form.|
|[**delete_keywordsets**](QualityApi.html#delete_keywordsets) | **DELETE** /api/v2/quality/keywordsets | Delete keyword sets|
|[**delete_keywordsets_keywordset_id**](QualityApi.html#delete_keywordsets_keywordset_id) | **DELETE** /api/v2/quality/keywordsets/{keywordSetId} | Delete a keywordSet by id.|
|[**get_agents_activity**](QualityApi.html#get_agents_activity) | **GET** /api/v2/quality/agents/activity | Gets a list of Agent Activities|
|[**get_calibrations**](QualityApi.html#get_calibrations) | **GET** /api/v2/quality/calibrations | Get the list of calibrations|
|[**get_calibrations_calibration_id**](QualityApi.html#get_calibrations_calibration_id) | **GET** /api/v2/quality/calibrations/{calibrationId} | Get a calibration by id.|
|[**get_conversations_conversation_id_audits**](QualityApi.html#get_conversations_conversation_id_audits) | **GET** /api/v2/quality/conversations/{conversationId}/audits | Get audits for conversation or recording|
|[**get_conversations_conversation_id_evaluations_evaluation_id**](QualityApi.html#get_conversations_conversation_id_evaluations_evaluation_id) | **GET** /api/v2/quality/conversations/{conversationId}/evaluations/{evaluationId} | Get an evaluation|
|[**get_evaluations_query**](QualityApi.html#get_evaluations_query) | **GET** /api/v2/quality/evaluations/query | Queries Evaluations and returns a paged list|
|[**get_evaluators_activity**](QualityApi.html#get_evaluators_activity) | **GET** /api/v2/quality/evaluators/activity | Get an evaluator activity|
|[**get_forms**](QualityApi.html#get_forms) | **GET** /api/v2/quality/forms | Get the list of evaluation forms|
|[**get_forms_form_id**](QualityApi.html#get_forms_form_id) | **GET** /api/v2/quality/forms/{formId} | Get an evaluation form|
|[**get_forms_form_id_versions**](QualityApi.html#get_forms_form_id_versions) | **GET** /api/v2/quality/forms/{formId}/versions | Gets all the revisions for a specific evaluation.|
|[**get_keywordsets**](QualityApi.html#get_keywordsets) | **GET** /api/v2/quality/keywordsets | Get the list of keyword sets|
|[**get_keywordsets_keywordset_id**](QualityApi.html#get_keywordsets_keywordset_id) | **GET** /api/v2/quality/keywordsets/{keywordSetId} | Get a keywordSet by id.|
|[**get_publishedforms**](QualityApi.html#get_publishedforms) | **GET** /api/v2/quality/publishedforms | Get the published evaluation forms.|
|[**get_publishedforms_form_id**](QualityApi.html#get_publishedforms_form_id) | **GET** /api/v2/quality/publishedforms/{formId} | Get the published evaluation forms.|
|[**post_calibrations**](QualityApi.html#post_calibrations) | **POST** /api/v2/quality/calibrations | Create a calibration|
|[**post_conversations_conversation_id_evaluations**](QualityApi.html#post_conversations_conversation_id_evaluations) | **POST** /api/v2/quality/conversations/{conversationId}/evaluations | Create an evaluation|
|[**post_evaluations_aggregates_query**](QualityApi.html#post_evaluations_aggregates_query) | **POST** /api/v2/analytics/evaluations/aggregates/query | Query for evaluation aggregates|
|[**post_evaluations_scoring**](QualityApi.html#post_evaluations_scoring) | **POST** /api/v2/quality/evaluations/scoring | Score evaluation|
|[**post_forms**](QualityApi.html#post_forms) | **POST** /api/v2/quality/forms | Create an evaluation form.|
|[**post_keywordsets**](QualityApi.html#post_keywordsets) | **POST** /api/v2/quality/keywordsets | Create a Keyword Set|
|[**post_publishedforms**](QualityApi.html#post_publishedforms) | **POST** /api/v2/quality/publishedforms | Publish an evaluation form.|
|[**post_spotability**](QualityApi.html#post_spotability) | **POST** /api/v2/quality/spotability | Retrieve the spotability statistic|
|[**put_calibrations_calibration_id**](QualityApi.html#put_calibrations_calibration_id) | **PUT** /api/v2/quality/calibrations/{calibrationId} | Update a calibration to the specified calibration via PUT. Editable fields include: evaluators, expertEvaluator, and scoringIndex|
|[**put_conversations_conversation_id_evaluations_evaluation_id**](QualityApi.html#put_conversations_conversation_id_evaluations_evaluation_id) | **PUT** /api/v2/quality/conversations/{conversationId}/evaluations/{evaluationId} | Update an evaluation|
|[**put_forms_form_id**](QualityApi.html#put_forms_form_id) | **PUT** /api/v2/quality/forms/{formId} | Update an evaluation form.|
|[**put_keywordsets_keywordset_id**](QualityApi.html#put_keywordsets_keywordset_id) | **PUT** /api/v2/quality/keywordsets/{keywordSetId} | Update a keywordSet to the specified keywordSet via PUT.|
{: class="table table-striped"}
## -[**Calibration**](Calibration.html) delete_calibrations_calibration_id(calibration_id, calibrator_id)
Delete a calibration by id.
### Example
~~~ruby
# load the gem
require 'purecloud'
# 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::QualityApi.new
calibration_id = "calibration_id_example" # String | Calibration ID
calibrator_id = "calibrator_id_example" # String | calibratorId
begin
#Delete a calibration by id.
result = api_instance.delete_calibrations_calibration_id(calibration_id, calibrator_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling QualityApi->delete_calibrations_calibration_id: #{e}"
end
~~~
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**calibration_id** | **String**| Calibration ID |
**calibrator_id** | **String**| calibratorId |
{: class="table table-striped"}
### Return type
[**Calibration**](Calibration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## -[**Evaluation**](Evaluation.html) delete_conversations_conversation_id_evaluations_evaluation_id(conversation_id, evaluation_id, opts)
Delete an evaluation
### Example
~~~ruby
# load the gem
require 'purecloud'
# 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::QualityApi.new
conversation_id = "conversation_id_example" # String | conversationId
evaluation_id = "evaluation_id_example" # String | evaluationId
opts = {
expand: "expand_example" # String | evaluatorId
}
begin
#Delete an evaluation
result = api_instance.delete_conversations_conversation_id_evaluations_evaluation_id(conversation_id, evaluation_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling QualityApi->delete_conversations_conversation_id_evaluations_evaluation_id: #{e}"
end
~~~
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId |
**evaluation_id** | **String**| evaluationId |
**expand** | **String**| evaluatorId | [optional]
{: class="table table-striped"}
### Return type
[**Evaluation**](Evaluation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## -String** delete_forms_form_id(form_id)
Delete an evaluation form.
### Example
~~~ruby
# load the gem
require 'purecloud'
# 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::QualityApi.new
form_id = "form_id_example" # String | Form ID
begin
#Delete an evaluation form.
result = api_instance.delete_forms_form_id(form_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling QualityApi->delete_forms_form_id: #{e}"
end
~~~
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**form_id** | **String**| Form ID |
{: class="table table-striped"}
### Return type
**String**
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## -String** delete_keywordsets(ids)
Delete keyword sets
Bulk delete of keyword sets; this will only delete the keyword sets that match the ids specified in the query param.
### Example
~~~ruby
# load the gem
require 'purecloud'
# 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::QualityApi.new
ids = "ids_example" # String | A comma-delimited list of valid KeywordSet ids
begin
#Delete keyword sets
result = api_instance.delete_keywordsets(ids)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling QualityApi->delete_keywordsets: #{e}"
end
~~~
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**ids** | **String**| A comma-delimited list of valid KeywordSet ids |
{: class="table table-striped"}
### Return type
**String**
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## - delete_keywordsets_keywordset_id(keyword_set_id)
Delete a keywordSet by id.
### Example
~~~ruby
# load the gem
require 'purecloud'
# 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::QualityApi.new
keyword_set_id = "keyword_set_id_example" # String | KeywordSet ID
begin
#Delete a keywordSet by id.
api_instance.delete_keywordsets_keywordset_id(keyword_set_id)
rescue PureCloud::ApiError => e
puts "Exception when calling QualityApi->delete_keywordsets_keywordset_id: #{e}"
end
~~~
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**keyword_set_id** | **String**| KeywordSet ID |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## -[**AgentActivityEntityListing**](AgentActivityEntityListing.html) get_agents_activity(opts)
Gets a list of Agent Activities
Including the number of evaluations and average evaluation score
### Example
~~~ruby
# load the gem
require 'purecloud'
# 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::QualityApi.new
opts = {
page_size: 25, # Integer | The total page size requested
page_number: 1, # Integer | The page number requested
sort_by: "sort_by_example", # String | variable name requested to sort by
expand: nil, # Array