Provide feedback for AI assistive search

Prev Next
Post
/v2/ProjectVersions/ask-ai-feedback
Security
API Key: api_token
Header parameter nameapi_token

Enter REST API key. To generate a key, go to Settings → Knowledge base portal → API tokens

Body parameters
Resync API reference request

Resync an API reference with specific apiReferenceId projectVersionId, userId and a spec file url or a file type.

{
  "entity_id": "",
  "is_liked": false,
  "comments": "",
  "notify_me_about_changes": false,
  "feedback_provider_email": "",
  "additional_feedback_info": {
    "need_more_information": false,
    "difficult_to_understand": false,
    "irrelevant_content": false,
    "incorrect_source_reference": false,
    "missing_information": false,
    "dont_like_style": false,
    "others": false,
    "comments": false
  },
  "feedback_sub_type": 0
}
Expand All
object
entity_id
string | null

Analytics ID returned by the ask-eddy response. Required to associate feedback with an ask-eddy query.

is_liked
boolean

Set to true if the user liked the AI response, and false if the user disliked the response.

comments
string | null

Optional user-provided feedback or suggestions about the AI response.

notify_me_about_changes
boolean

Set to true if the user wants to be notified when there is a response to their feedback.

feedback_provider_email
string | null

Email address of the user submitting the feedback. Required if notify_me_about_changes is set to true.

additional_feedback_info
object | null

Additional details about the user’s feedback. Helps categorize user feedback and respond effectively.

need_more_information
boolean

User needs more information than what was provided in the AI response.

difficult_to_understand
boolean

The AI response was difficult for the user to understand.

irrelevant_content
boolean

The AI response was not relevant to the user's query.

incorrect_source_reference
boolean

The source references in the AI response were incorrect or misleading.

missing_information
boolean

Important information was missing from the AI response.

dont_like_style
boolean

The user did not like the style of the AI response.

others
boolean

The user's feedback does not fall under the predefined categories.

comments
boolean

Indicates whether the user has provided additional comments.

feedback_sub_type
integer (int32)

Set to 0 if the user did not receive a response to their query. Set to 1 if they received a response but were not satisfied with it.

Valid values[ 0, 1 ]
Resync API reference request

Resync an API reference with specific apiReferenceId projectVersionId, userId and a spec file url or a file type.

{
  "entity_id": "",
  "is_liked": false,
  "comments": "",
  "notify_me_about_changes": false,
  "feedback_provider_email": "",
  "additional_feedback_info": {
    "need_more_information": false,
    "difficult_to_understand": false,
    "irrelevant_content": false,
    "incorrect_source_reference": false,
    "missing_information": false,
    "dont_like_style": false,
    "others": false,
    "comments": false
  },
  "feedback_sub_type": 0
}
Expand All
object
entity_id
string | null

Analytics ID returned by the ask-eddy response. Required to associate feedback with an ask-eddy query.

is_liked
boolean

Set to true if the user liked the AI response, and false if the user disliked the response.

comments
string | null

Optional user-provided feedback or suggestions about the AI response.

notify_me_about_changes
boolean

Set to true if the user wants to be notified when there is a response to their feedback.

feedback_provider_email
string | null

Email address of the user submitting the feedback. Required if notify_me_about_changes is set to true.

additional_feedback_info
object | null

Additional details about the user’s feedback. Helps categorize user feedback and respond effectively.

need_more_information
boolean

User needs more information than what was provided in the AI response.

difficult_to_understand
boolean

The AI response was difficult for the user to understand.

irrelevant_content
boolean

The AI response was not relevant to the user's query.

incorrect_source_reference
boolean

The source references in the AI response were incorrect or misleading.

missing_information
boolean

Important information was missing from the AI response.

dont_like_style
boolean

The user did not like the style of the AI response.

others
boolean

The user's feedback does not fall under the predefined categories.

comments
boolean

Indicates whether the user has provided additional comments.

feedback_sub_type
integer (int32)

Set to 0 if the user did not receive a response to their query. Set to 1 if they received a response but were not satisfied with it.

Valid values[ 0, 1 ]
Resync API reference request

Resync an API reference with specific apiReferenceId projectVersionId, userId and a spec file url or a file type.

{
  "entity_id": "",
  "is_liked": false,
  "comments": "",
  "notify_me_about_changes": false,
  "feedback_provider_email": "",
  "additional_feedback_info": {
    "need_more_information": false,
    "difficult_to_understand": false,
    "irrelevant_content": false,
    "incorrect_source_reference": false,
    "missing_information": false,
    "dont_like_style": false,
    "others": false,
    "comments": false
  },
  "feedback_sub_type": 0
}
Expand All
object
entity_id
string | null

Analytics ID returned by the ask-eddy response. Required to associate feedback with an ask-eddy query.

is_liked
boolean

Set to true if the user liked the AI response, and false if the user disliked the response.

comments
string | null

Optional user-provided feedback or suggestions about the AI response.

notify_me_about_changes
boolean

Set to true if the user wants to be notified when there is a response to their feedback.

feedback_provider_email
string | null

Email address of the user submitting the feedback. Required if notify_me_about_changes is set to true.

additional_feedback_info
object | null

Additional details about the user’s feedback. Helps categorize user feedback and respond effectively.

need_more_information
boolean

User needs more information than what was provided in the AI response.

difficult_to_understand
boolean

The AI response was difficult for the user to understand.

irrelevant_content
boolean

The AI response was not relevant to the user's query.

incorrect_source_reference
boolean

The source references in the AI response were incorrect or misleading.

missing_information
boolean

Important information was missing from the AI response.

dont_like_style
boolean

The user did not like the style of the AI response.

others
boolean

The user's feedback does not fall under the predefined categories.

comments
boolean

Indicates whether the user has provided additional comments.

feedback_sub_type
integer (int32)

Set to 0 if the user did not receive a response to their query. Set to 1 if they received a response but were not satisfied with it.

Valid values[ 0, 1 ]
Resync API reference request

Resync an API reference with specific apiReferenceId projectVersionId, userId and a spec file url or a file type.

{
  "entity_id": "",
  "is_liked": false,
  "comments": "",
  "notify_me_about_changes": false,
  "feedback_provider_email": "",
  "additional_feedback_info": {
    "need_more_information": false,
    "difficult_to_understand": false,
    "irrelevant_content": false,
    "incorrect_source_reference": false,
    "missing_information": false,
    "dont_like_style": false,
    "others": false,
    "comments": false
  },
  "feedback_sub_type": 0
}
Expand All
object
entity_id
string | null

Analytics ID returned by the ask-eddy response. Required to associate feedback with an ask-eddy query.

is_liked
boolean

Set to true if the user liked the AI response, and false if the user disliked the response.

comments
string | null

Optional user-provided feedback or suggestions about the AI response.

notify_me_about_changes
boolean

Set to true if the user wants to be notified when there is a response to their feedback.

feedback_provider_email
string | null

Email address of the user submitting the feedback. Required if notify_me_about_changes is set to true.

additional_feedback_info
object | null

Additional details about the user’s feedback. Helps categorize user feedback and respond effectively.

need_more_information
boolean

User needs more information than what was provided in the AI response.

difficult_to_understand
boolean

The AI response was difficult for the user to understand.

irrelevant_content
boolean

The AI response was not relevant to the user's query.

incorrect_source_reference
boolean

The source references in the AI response were incorrect or misleading.

missing_information
boolean

Important information was missing from the AI response.

dont_like_style
boolean

The user did not like the style of the AI response.

others
boolean

The user's feedback does not fall under the predefined categories.

comments
boolean

Indicates whether the user has provided additional comments.

feedback_sub_type
integer (int32)

Set to 0 if the user did not receive a response to their query. Set to 1 if they received a response but were not satisfied with it.

Valid values[ 0, 1 ]
Responses
200

Success

Success status response

This is sample response for this endpoint.

{
  "extension_data": null,
  "context": null,
  "success": true,
  "errors": [],
  "warnings": [],
  "information": [],
  "feature_explorer_status": null,
  "custom_page_element": null
}
Expand All
object
extension_data
object | null
context
object | null
extension_data
object | null
caller_reference
string | null
success
boolean
errors
Array of object (BaseError) | null
object
extension_data
object | null

Thids is the Extention data object

stack_trace
string | null

Stack trace for error response message

description
string | null

Description for error cause

error_code
string | null

Error code for Api response

custom_data
object | null
property*
warnings
Array of object (BaseWarning) | null
object
extension_data
object | null

Extention Data for customer Api warning

description
string | null

Warning description

warning_code
string | null

warning code for customer Api base response

information
Array of object (BaseInformation) | null
object
extension_data
object | null

Extention data for customer Api response information

description
string | null

status description for customer Api response information

feature_explorer_status
object | null
feature_usage_score
number (double)
section
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5 ]
feature_id
string | null
feature_name
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 ]
advanced_feature_user_role
integer (int32)
Valid values[ 0, 1, 2 ]
feature_explorer_user_analytics
object | null
id
string | null
project_id
string | null
user_id
string | null
trophy_status
object | null
first
boolean
second
boolean
third
boolean
fourth
boolean
show_default
boolean
show_advanced_section_popup
boolean
hide_popup
boolean
hide_popup_date
string (date-time)
is_advanced_section_unlocked
boolean
usage_score
number (double)
features
Array of object (FeatureAnalytics) | null
object
section
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5 ]
feature_name
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 ]
is_feature_explored
boolean
time_stamp
string (date-time)
is_closed_content_reuse_info
boolean
custom_page_element
object | null
element_type
integer (int32)
Valid values[ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 100, 101, 102, 103, 104, 105, 106, 107, 108 ]
element_name
string | null
element_guid
string | null
display_name
string | null
view_styles
object | null
property*
view_properties
object | null
property*
editable_properties
Array of object (FormEditableProperties) | null
object
element_name
string | null
element_type
integer (int32) | null
Valid values[ 0, 1, 2, 3, 4, 5, 6, 7, 8 ]
label
string | null
value
string | null
view_form_control
object | null
property_key
string | null
is_children
integer (int32)
view_type
string | null
element_name
string | null
is_children_root
boolean
element_type
string | null
inverted_value
boolean
is_dirty
boolean
editable_properties
object | null Recursive
element_guid
string | null
children
Array of object (FormEditableProperties) | null
object Recursive
edit_component_style_properties
object | null
property*
edit_component_properties
object | null
property*
children
Array of object (UIElement) | null
object Recursive
400

Bad Request

Invalid analyticsId

Kindly ensure the analyticsId is not empty and perform the task again.

{
  "extension_data": null,
  "success": false,
  "errors": [
    {
      "extension_data": null,
      "stack_trace": null,
      "description": "AnalyticsId should not be empty",
      "error_code": null,
      "custom_data": null
    }
  ],
  "warnings": [],
  "information": []
}
Invalid projectDocumentVersionId

Kindly ensure the projectDocumentVersionId is not empty and perform the task again.

{
  "extension_data": null,
  "success": false,
  "errors": [
    {
      "extension_data": null,
      "stack_trace": null,
      "description": "ProjectDocumentVersionId should not be empty",
      "error_code": null,
      "custom_data": null
    }
  ],
  "warnings": [],
  "information": []
}
Invalid languageCode

Kindly ensure the languageCode is not empty and perform the task again.

{
  "extension_data": null,
  "success": false,
  "errors": [
    {
      "extension_data": null,
      "stack_trace": null,
      "description": "LanguageCode should not be empty",
      "error_code": null,
      "custom_data": null
    }
  ],
  "warnings": [],
  "information": []
}
Expand All
object
extension_data
object | null
context
object | null
extension_data
object | null
caller_reference
string | null
success
boolean
errors
Array of object (BaseError) | null
object
extension_data
object | null

Thids is the Extention data object

stack_trace
string | null

Stack trace for error response message

description
string | null

Description for error cause

error_code
string | null

Error code for Api response

custom_data
object | null
property*
warnings
Array of object (BaseWarning) | null
object
extension_data
object | null

Extention Data for customer Api warning

description
string | null

Warning description

warning_code
string | null

warning code for customer Api base response

information
Array of object (BaseInformation) | null
object
extension_data
object | null

Extention data for customer Api response information

description
string | null

status description for customer Api response information

feature_explorer_status
object | null
feature_usage_score
number (double)
section
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5 ]
feature_id
string | null
feature_name
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 ]
advanced_feature_user_role
integer (int32)
Valid values[ 0, 1, 2 ]
feature_explorer_user_analytics
object | null
id
string | null
project_id
string | null
user_id
string | null
trophy_status
object | null
first
boolean
second
boolean
third
boolean
fourth
boolean
show_default
boolean
show_advanced_section_popup
boolean
hide_popup
boolean
hide_popup_date
string (date-time)
is_advanced_section_unlocked
boolean
usage_score
number (double)
features
Array of object (FeatureAnalytics) | null
object
section
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5 ]
feature_name
integer (int32)
Valid values[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 ]
is_feature_explored
boolean
time_stamp
string (date-time)
is_closed_content_reuse_info
boolean
custom_page_element
object | null
element_type
integer (int32)
Valid values[ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 100, 101, 102, 103, 104, 105, 106, 107, 108 ]
element_name
string | null
element_guid
string | null
display_name
string | null
view_styles
object | null
property*
view_properties
object | null
property*
editable_properties
Array of object (FormEditableProperties) | null
object
element_name
string | null
element_type
integer (int32) | null
Valid values[ 0, 1, 2, 3, 4, 5, 6, 7, 8 ]
label
string | null
value
string | null
view_form_control
object | null
property_key
string | null
is_children
integer (int32)
view_type
string | null
element_name
string | null
is_children_root
boolean
element_type
string | null
inverted_value
boolean
is_dirty
boolean
editable_properties
object | null Recursive
element_guid
string | null
children
Array of object (FormEditableProperties) | null
object Recursive
edit_component_style_properties
object | null
property*
edit_component_properties
object | null
property*
children
Array of object (UIElement) | null
object Recursive