Update Survey Feedback (Partial Update)

PATCH /calls/surveys/{survey_id}/

Use the PATCH /calls/surveys/{survey_id}/ endpoint to update specific fields in an existing survey. This allows you to modify selected feedback about a service experience without altering the entire survey.

Path Parameter

Name
Type
Description

survey_id

string

Unique ID of the survey to update.

Request Body

The body contains only the fields you want to update. All fields are optional, but you must include at least one. Below are the fields available for update:

Name
Type
Description

disappointment_level

string

Level of disappointment. Values are Very, Somewhat, Not

disappointment_reason

string

Reason for disappointment

problem_solved

boolean

Indicates if the issue was resolved

responded_immediately

boolean

Whether the mechanic responded promptly

is_carried_along

boolean

Indicates if the customer was informed

was_asked_before_maintenance

boolean

Mechanic asked before proceeding with maintenance

had_effective_communication

boolean

Indicates effective communication

kept_appointment

boolean

Indicates if the appointment was kept

met_at_location

boolean

Mechanic met at the agreed location

met_at_shop

boolean

Mechanic met at the shop

auto_technician_rating

integer

Rating for the mechanic

auto_technician_feedback

string

Feedback for the mechanic

customer_support_experience

string

Feedback on customer support

overall_experience_rating

integer

Rating for the overall experience

overall_feedback

string

General feedback

refer_to_friend

boolean

Indicates willingness to recommend

user

string

ID of the user who provided the survey

call

integer

ID of the related call


Sample Request Body

{
  "disappointment_level": "Somewhat",
  "disappointment_reason": "The mechanic arrived late",
  "problem_solved": true,
  "responded_immediately": false,
  "is_carried_along": true,
  "was_asked_before_maintenance": false,
  "had_effective_communication": true,
  "kept_appointment": false,
  "met_at_location": true,
  "met_at_shop": false,
  "auto_technician_rating": 8,
  "auto_technician_feedback": "The mechanic was skilled and fixed the issue well.",
  "customer_support_experience": "Responsive and helpful support team.",
  "overall_experience_rating": 9,
  "overall_feedback": "Overall, a positive experience.",
  "refer_to_friend": true,
  "user": "user123",
  "call": 56789
}

Response

  • Status Code: 200 OK

  • Response Content Type: JSON

  • Description: The survey was successfully updated.

Response Body Example

{
  "id": "d23f5a1e-2c8b-4d2f-a98b-7b45af3e9eab",
  "disappointment_level": "very",
  "disappointment_reason": "Mechanic arrived late",
  "problem_solved": true,
  "responded_immediately": false,
  "is_carried_along": true,
  "was_asked_before_maintenance": true,
  "had_effective_communication": true,
  "kept_appointment": false,
  "met_at_location": true,
  "met_at_shop": false,
  "auto_technician_rating": 9,
  "auto_technician_feedback": "Very professional and skilled.",
  "customer_support_experience": "Helpful and responsive.",
  "overall_experience_rating": 8,
  "overall_feedback": "Good experience overall, but could improve punctuality.",
  "refer_to_friend": true,
  "created_at": "2024-11-12T10:00:00Z",
  "updated_at": "2024-11-12T11:00:00Z",
  "user": "user123",
  "call": 456
}

Notes

  • This endpoint supports partial updates, meaning you only need to send fields that you wish to change.

  • Ensure the survey_id is valid and corresponds to an existing survey.

  • The user and call fields are required for all updates.

Last updated