Optimly Developer Documentation

Optimly MCP

Delta Report Details

In short

Return per-question, per-model answers from a completed audit, including answer text, expected ground truth, accuracy, and owned versus third-party citations.

delta_report_details · Partner Program · Authentication required

Return per-question, per-model answers from a completed audit, including answer text, expected ground truth, accuracy, and owned versus third-party citations.

When to use

Use to understand why a score moved or identify exact claims and sources that need correction.

Access

Partner Program or approved access with read_brand permission

Parameters

ParameterTypeRequiredDescription
run_idstringYesCompleted audit run ID from delta_report or delta_report_history.
limitnumberNoMaximum answers; default and maximum 50.
offsetnumberNoPagination offset.
only_groundedbooleanNoOnly include answers with citations.
brand_slugstringNoBrand selector for internal superadmin keys. Brand-scoped keys ignore it; OAuth users select an authorized brand with brand_id.

Example prompt

Which questions did AI answer incorrectly in our latest audit?

Example request

{
  "run_id": "run_123",
  "only_grounded": true
}