Optimly Developer Documentation

Optimly MCP

Delta Report History

In short

List completed audit runs newest-first with component scores and run-over-run deltas.

delta_report_history · Partner Program · Authentication required

List completed audit runs newest-first with component scores and run-over-run deltas.

When to use

Use to evaluate trends and select historical runs for comparison.

Access

Partner Program or approved access with read_brand permission

Parameters

ParameterTypeRequiredDescription
limitnumberNoMaximum runs; default 10, maximum 50.
sincestringNoOnly runs completed after this ISO-8601 date.
brand_slugstringNoBrand selector for internal superadmin keys. Brand-scoped keys ignore it; OAuth users select an authorized brand with brand_id.

Example prompt

How has our BAI changed since January?

Example request

{
  "since": "2026-01-01",
  "limit": 12
}