Authenticity

Mark an authenticity score as contested

Stamp the latest score row as disputed by the caller's workspace.

Required for legal cover (PM revision): every authenticity score must be challengeable on day 1. We don't retract the score on dispute — we just attach the operator's note + workspace id so the UI can render "Contested by Acme on 2026-04-01" alongside the badge, and downstream consumers (filters, alerts) can skip disputed scores if they want.

Workspace resolution is best-effort: if the caller has no workspace binding the dispute still records (with NULL workspace), so legacy CLI keys can flag scores too.

post/api/kols/{username}/authenticity/dispute

Request

  • Base URL: https://api.kolens.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.kolens.ai/api/kols/{username}/authenticity/dispute
  • Auth: HTTP bearer

Path parameters

usernamestring required

Query parameters

platformstring

Headers

x-kolens-user-idstring nullable
x-kolens-workspace-idstring nullable

Request body

notestring nullable

Optional explanation of why this score is contested.

Response

Successful Response

usernamestring required
platformstring required
algorithm_versionstring required
snapshot_datestring required
scoreinteger required
confidencestring required
signalsobject required
disputed_atstring nullable
disputed_by_workspace_idstring nullable
dispute_notestring nullable
computed_atstring required
summarystring required

Changes

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