API Reference
Log In
API Reference

Post insights feedback

Record feedback on one recommendation in an insights run: what you did with it, how useful it was, and optionally the savings you realized. Feedback events are append-only, so posting again adds a new event instead of changing an earlier one. The response is the event that was recorded.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Hashed id of the team to answer for. Optional. With a user token it may be any team the user belongs to; without it the user's default team answers. An API key always answers for its own team, and naming any other team is refused with 403.

Body Params
string
required

ID of the run the recommendation belongs to.

string
required

ID of the recommendation the feedback is about.

string
enum
required

What was done with the recommendation: acknowledged, implemented, dismissed, not_applicable or already_aware.

Allowed:
string

Why you dismissed the recommendation. Optional; defaults to an empty string.

integer
required
-1 to 1

Your rating of the recommendation, as an integer: 1 if it was good and useful, 0 for no rating or neutral, -1 if it was bad or not useful.

number | null
Defaults to 0

Savings you actually realized, as an amount in the currency given by realizedSavingsCurrency. Defaults to 0.

string
^[A-Za-z]{3}$
Defaults to USD

Three-letter ISO 4217 currency code of realizedSavings. Defaults to USD.

string | null
Defaults to null

When the realized savings were measured, ISO 8601 in UTC. Optional; defaults to null.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json