Skip to main content

Submit Call Feedback

POST 
/v1/users/{userId}/calls/{callId}/feedback

Submit user feedback for a specific call, helping improve AI screening accuracy and caller reputation data.

Feedback Types​

Users can provide feedback on:

  • Screening Accuracy: Was the call correctly identified as spam/scam/legitimate?
  • AI Assistant Performance: Did the assistant handle the call appropriately?
  • Caller Identity: Correct or update the caller identification

Impact​

Feedback is processed asynchronously and contributes to:

  • Improving the AI screening model for better call classification
  • Updating Hiya's global caller reputation database
  • Refining personalized screening for this user's preferences

The 202 Accepted response indicates feedback was queued for processing.

Path Parameters​

    userId stringrequired

    UUID for the given user

    callId stringrequired

    UUID for the given call

Header Parameters​

    x-hiya-product-version string

    Product version. The standard "major.minor.patch" format is highly encouraged without any leading characters; "2.1.3" or "3.0.0" for example.

    x-hiya-account-user-id stringrequired

    The identifier of a logged-in user. Same identifier that is used for /users/{user_id}

Body

required

application/json

Responses​

Accepted