Accuracy Feedback

Submit Line Feedback

Record one signal from one reader.

Authenticated so only signed-in users can post, and then the identity is dropped: current_user is not passed to record_line_feedback, so the feedback row itself carries nothing that ties it to an account or a shipment.

The one deliberate exception: a "flagged" signal bumps an opaque per-tenant counter in vectelos_activation (via note_thumbs_down) so a marketing cohort's flag rate is visible. That store holds counts only — no feedback content, no HTS code, nothing joinable back to what was flagged. See GTM_plan.md §4.4.

post/v1/feedback

Request

  • Base URL: https://api.vectelos.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.vectelos.com/v1/feedback
  • Auth: none declared

Headers

authorizationstring nullable

Bearer <JWT session token>

Cookies

vx_sessionstring nullable

Request body

signal'flagged' | 'extraction_error' | 'description_confirmed' | 'description_wrong' required

What the reader is telling us

hts_codestring

The code the engine selected

confidencenumber nullable

Engine confidence, 0-1

duty_rate_pctnumber nullable

Effective rate applied

chapter99_codesstring[]

Remedy headings applied, e.g. 9903.82.02

caveats_firedinteger

How many determinations the engine declined to make

engine_reasoningstring nullable

The engine's own stated reasoning for this classification

origin_countrystring nullable
port_citystring nullable
port_statestring nullable
what_is_wrongstring nullable

Which part looks wrong, from a fixed list the UI offers

suggested_hts_codestring nullable
commentstring nullable
include_descriptionboolean

True only when the reader chose to send the item description

item_descriptionstring nullable

Sent only when include_description is true; dropped otherwise

Response

Successful Response

recordedboolean required
description_includedboolean required

Echoes back whether the description was stored, so the UI can tell the reader what actually left their browser

messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.