FAfactorialhr
Ats > Feedback

Updates a Feedback

Changed on

This endpoint allows to update existing feedback entries associated with candidates' applications.

put/api/2026-10-01/resources/ats/feedbacks/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/ats/feedbacks/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: recruitment
    • or API key in header x-api-key

Path parameters

idstring required

the ID of the feedback entry to be updated.

Request body

idstring

the ID of the feedback entry to be updated.

ratinginteger

the overall rating from 1 to 5 for the candidate's application.

descriptionstring

the description of the feedback provided.

ats_application_phase_idstring

the ID of the phase within the application related to the feedback.

Example request

{
  "id": "1",
  "rating": 5,
  "description": "The candidate has a great attitude and is a good fit for the team.",
  "ats_application_phase_id": "1"
}

Response

OK

idstring required

the ID of the feedback entry.

ratinginteger

the overall rating from 1 to 5 for the candidate's application.

descriptionstring

the description of the feedback provided.

ats_application_idstring

the ID of the application related to the feedback.

ats_application_phase_idstring

the ID of the phase within the application related to the feedback.

created_atstring required

the date and time when the feedback entry was created.

ats_candidate_idstring required

the ID of the candidate to whom the feedback is associated.

ats_evaluation_forms_idstring

the ID of the evaluation form to which the feedback belongs if the evaluation forms feature is active.

Example response

{
  "id": "1",
  "rating": 4,
  "description": "The candidate has a great attitude and is a good fit for the team.",
  "ats_application_id": "1",
  "ats_application_phase_id": "1",
  "created_at": "2022-01-01T00:00:00Z",
  "ats_candidate_id": "1",
  "ats_evaluation_forms_id": "1",
  "evaluation_form_answers": [
    {
      "id": 1,
      "score": 3,
      "note": "Good communication skills."
    }
  ]
}

Changes