Login Book a demo

Runs

Get a transcript

Read one run, turn by turn.

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

How it works

You get what the user and the agent said in each turn, with the name and timing of each step the agent took, such as a tool call. Long transcripts come one page of turns at a time.

If there is no transcript for that run, available is false and there are no turns.

Authorization

  • Authorizationheaderrequired

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

Request body

application/json

  • run_idstringrequired

    Your ID for the run.

  • sourcestring

    Only needed if the same run_id was used for a run Ollive collected and one that was sent.

    platformapimcp
  • limitintegerdefault 25up to 100

    How many turns to return per page.

  • cursorstring

    The next_cursor from the previous page.

Response

The transcript.

  • run_idstringrequired

    Your ID for the run.

  • sourcestringrequired

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

    platformapimcp
  • availablebooleanrequired

    Whether a transcript is available.

  • turnsobject[]required

    The conversation, turn by turn.

    • turn_indexintegerrequired

      The turn’s position, starting at 1. Quotes and flagged steps refer to turns by this number.

    • started_atstring (date-time)

      When the turn started.

    • ended_atstring (date-time)

      When it ended.

    • user_textstringrequired

      What the user said.

    • agent_textstringrequired

      What the agent said.

    • stepsobject[]required

      The steps the agent took, such as tool calls.

      • namestringrequired

        The step’s name.

      • kindstringrequired

        What kind of step it was.

        toolmodelother
      • started_atstring (date-time)

        When it started.

      • ended_atstring (date-time)

        When it finished.

      • errorbooleanrequired

        Whether the step failed.

    • errorbooleanrequired

      Whether the turn had an error.

  • 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.

← List runsList findings →