Login Book a demo

Runs

List runs

See the runs Ollive has checked, newest first.

POSThttps://api.ollive.ai/api/runs/query/v1
Safe to retryPagedv1

How it works

Each run has a state, and counts of the rules it met and didn’t meet:

  • checked: checking is finished.
  • checking: checking is still running.
  • error: the run couldn’t be checked.
  • skipped: it wasn’t a real conversation, so it wasn’t checked.

Runs you send appear here once checking begins. For the detailed results of one run, use List results.

Authorization

  • Authorizationheaderrequired

    Your API key, after the word Bearer, like this: Bearer ollive_sk_…. Create a key.

Request body

application/json

  • agent_idstring

    Only show this agent’s runs.

  • run_idsstring[]up to 100

    Only show these runs, by your IDs.

  • statesstring[]

    Only show runs in these states.

    checkedcheckingerrorskipped
  • sincestringdefault 30d

    How far back to look, such as 30m, 12h, 7d, or all for everything.

  • limitintegerdefault 25up to 100

    How many to return per page.

  • cursorstring

    The next_cursor from the previous page.

  • sourcesstring[]

    Which runs to include: platform for ones Ollive collected, api or mcp for ones you sent. Leave it out to include all.

    platformapimcp

Response

The runs found. An empty list if there are none.

  • dataobject[]required

    One entry per run.

    • run_idstringrequired

      Your ID for the run.

    • sourcestringrequired

      platform if Ollive collected it, api or mcp if it was sent to Ollive.

      platformapimcp
    • agent_idstringrequired

      The agent it belongs to.

    • statestringrequired

      Where checking has got to. See above.

      checkedcheckingerrorskipped
    • started_atstring (date-time)

      When the run started.

    • ended_atstring (date-time)

      When it ended.

    • duration_msinteger

      How long it lasted, in milliseconds.

    • checked_atstring (date-time)

      When checking finished.

    • met_countintegerrequired

      How many rules it met.

    • not_met_countintegerrequired

      How many rules it didn’t meet.

    • inconclusive_countintegerrequired

      How many rules Ollive couldn’t decide on.

  • total_countintegerrequired

    How many results match, across all pages.

  • has_morebooleanrequired

    Whether there is another page.

  • next_cursorstringrequired

    Send this as cursor to get the next page. Empty on the last page.

← Send runsGet a transcript →