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

# List runs

> Lists an automation's runs, newest first.



## OpenAPI

````yaml /api-reference/openapi.json get /automations/{automationId}/runs
openapi: 3.1.0
info:
  description: >-
    Manage a Superlog workspace's automations, runs, tag mode, model access, and
    secrets, read its telemetry, build dashboards and alerts over it, run
    synthetic checks, and export them to Terraform. Every request acts as the
    member who created the API key.
  title: Superlog management API
  version: 1.0.0
servers:
  - url: https://superlog.sh/api/v1
security:
  - bearerAuth: []
tags:
  - description: Connected integrations and the IDs automations and tag mode use.
    name: Integrations
  - description: The workspace and its members.
    name: Workspace
  - description: Keys that authenticate the management API and MCP server.
    name: API keys
  - description: Create and change automations.
    name: Automations
  - description: Start, follow, and cancel automation runs.
    name: Runs
  - description: What Superlog can use and change when someone mentions it in Slack.
    name: Tag mode
  - description: Model API keys, subscriptions, and available models.
    name: Models
  - description: Credentials agents can use without seeing them.
    name: Secrets
  - description: Read the workspace's logs, traces, and metrics.
    name: Telemetry
  - description: >-
      Exceptions in the workspace's telemetry, grouped into issues by
      fingerprint.
    name: Errors
  - description: Create and change dashboards over the workspace's telemetry.
    name: Dashboards
  - description: Threshold alerts on the workspace's telemetry that post to Slack.
    name: Alerts
  - description: HTTP checks that request a URL on a schedule and post failures to Slack.
    name: Synthetics
  - description: Configuration for the superloglabs/superlog Terraform provider.
    name: Terraform
paths:
  /automations/{automationId}/runs:
    get:
      tags:
        - Runs
      summary: List runs
      description: Lists an automation's runs, newest first.
      operationId: list_automation_runs
      parameters:
        - description: Automation ID.
          in: path
          name: automationId
          required: true
          schema:
            type: string
            format: uuid
            description: Automation ID.
        - description: Page number, starting at 1.
          in: query
          name: page
          required: false
          schema:
            default: 1
            description: Page number, starting at 1.
            type: integer
            minimum: 1
            maximum: 10000
        - description: Runs per page, up to 50.
          in: query
          name: pageSize
          required: false
          schema:
            default: 10
            description: Runs per page, up to 50.
            type: integer
            minimum: 1
            maximum: 50
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: integer
                  pageSize:
                    type: integer
                  runs:
                    type: array
                    items:
                      type: object
                      properties:
                        completedAt:
                          anyOf:
                            - type: string
                              format: date-time
                              description: When the run finished.
                            - type: 'null'
                        createdAt:
                          type: string
                          format: date-time
                          description: When the run was created.
                        failureCategory:
                          anyOf:
                            - type: string
                            - type: 'null'
                        failureMessage:
                          anyOf:
                            - type: string
                            - type: 'null'
                        id:
                          type: string
                          format: uuid
                          description: Run ID.
                        inferenceUsage:
                          anyOf:
                            - type: object
                              properties:
                                costMicros:
                                  anyOf:
                                    - type: integer
                                    - type: 'null'
                                  description: >-
                                    Model cost in millionths of a US dollar.
                                    Null when a price is unknown.
                                inputTokens:
                                  type: integer
                                outputTokens:
                                  type: integer
                                requests:
                                  type: integer
                              required:
                                - costMicros
                                - inputTokens
                                - outputTokens
                                - requests
                              additionalProperties: false
                            - type: 'null'
                        number:
                          type: integer
                          description: >-
                            The run's position in the automation's history,
                            starting at 1.
                        resultSummary:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: The agent's final answer.
                        startedAt:
                          anyOf:
                            - type: string
                              format: date-time
                              description: When the run started.
                            - type: 'null'
                        status:
                          type: string
                          enum:
                            - pending
                            - running
                            - succeeded
                            - failed
                            - cancelled
                          description: '`pending` and `running` runs are active.'
                        trigger:
                          type: object
                          properties:
                            provider:
                              type: string
                              description: >-
                                What started the run: `manual`, `schedule`,
                                `slack`, `sentry`, `errors`, `axiom`, `signoz`,
                                `honeycomb`, `betterstack`, `devrev`, `github`,
                                `discord`, or `webhook`.
                            sourceUrl:
                              anyOf:
                                - type: string
                                - type: 'null'
                              description: A link to the event that started the run.
                            title:
                              type: string
                          required:
                            - provider
                            - sourceUrl
                            - title
                          additionalProperties: false
                      required:
                        - completedAt
                        - createdAt
                        - failureCategory
                        - failureMessage
                        - id
                        - inferenceUsage
                        - number
                        - resultSummary
                        - startedAt
                        - status
                        - trigger
                      additionalProperties: false
                  total:
                    type: integer
                    description: Runs across all pages.
                required:
                  - page
                  - pageSize
                  - runs
                  - total
                additionalProperties: false
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The request is invalid. `issues` lists each invalid field.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The API key is missing, revoked, or its creator left the workspace.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            The resource does not exist in this workspace, or the feature it
            belongs to is not enabled.
      security:
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        code:
          description: A stable machine-readable error code, when there is one.
          type: string
        error:
          type: string
          description: What went wrong.
        issues:
          description: Validation problems, one per invalid field.
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              path:
                type: array
                items:
                  anyOf:
                    - type: string
                    - type: number
            required:
              - message
              - path
            additionalProperties: false
      required:
        - error
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      description: A workspace API key, created in Superlog under Settings → API keys.
      scheme: bearer
      type: http

````

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