Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-GitHits-Session-ID
string | null

Required exactly once when solution_id is omitted: identifies the session to rate. Must be 16 lowercase hexadecimal characters, with no whitespace. For solution feedback, this header is optional client attribution.

Pattern: ^[0-9a-f]{16}$
​
X-GitHits-Client-Name
string | null

Optional client attribution, trimmed printable ASCII, maximum 80 bytes.

​
X-GitHits-Client-Version
string | null

Optional client version attribution, trimmed printable ASCII, maximum 80 bytes.

​
X-GitHits-Agent
string | null

Optional agent attribution, trimmed printable ASCII, maximum 160 bytes.

Body

application/json

Append a decision to one solution or a caller-supplied session.

​
accepted
boolean
required

Whether the example or session was useful: true for acceptance, false for rejection.

Example:

false

​
feedback_text
string | null

Optional text preserved exactly, including empty string; omitted/null means no text.

​
solution_id
string<uuid>

Saved example to rate, using the solution_id returned by example generation. Must be a hyphenated UUID. Omit to rate the session identified by X-GitHits-Session-ID; null and empty values are invalid.

​
tool_name
string

Optional nonblank tool attribution; not a tool-call target. Null is invalid.

Minimum string length: 1

Response

New append-only feedback record, confirmed by the backend.

Confirmation of a newly saved feedback record.

​
accepted
boolean
required

Server-confirmed accepted/rejected decision.

​
id
string<uuid>
required

UUID of the newly saved feedback record.

​
target_type
enum<string>
required

Whether the feedback targets a saved solution or a session.

Available options:
solution,
session