> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revyops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List AI Runs

> AI runs, newest first: one per workflow run with AI steps and one per task an agent opened with start_run, with task, who ran it, status, result, refused calls, model, tokens and how many records it changed.



## OpenAPI

````yaml GET /public/ai-runs/
openapi: 3.0.3
info:
  title: RevyOps API
  version: 1.0.0
servers:
  - url: https://app.revyops.com/api
security:
  - ApiKeyAuth: []
paths:
  /public/ai-runs/:
    get:
      tags:
        - System log
      description: >-
        AI runs, newest first: one per workflow run with AI steps and one per
        task an agent opened with start_run, with task, who ran it, status,
        result, refused calls, model, tokens and how many records it changed.
      operationId: List AI runs
      parameters:
        - in: query
          name: page
          schema:
            type: integer
          description: Page number, from 1.
        - in: query
          name: per_page
          schema:
            type: integer
          description: 25, 50 (default) or 100.
        - in: query
          name: q
          schema:
            type: string
          description: Task, status, result or the start of a run id.
        - in: query
          name: since
          schema:
            type: string
          description: ISO 8601 time; defaults to the start of the log, six months back.
        - in: query
          name: source
          schema:
            type: string
          description: workflow or mcp.
        - in: query
          name: status
          schema:
            type: string
          description: unfinished, waiting_approval, completed, failed or stopped.
        - in: query
          name: until
          schema:
            type: string
          description: ISO 8601 time.
        - in: query
          name: workflow_id
          schema:
            type: integer
          description: Only the runs of this workflow.
      responses:
        '200':
          description: No response body
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.