> ## Documentation Index > Fetch the complete documentation index at: https://docs.outlit.ai/llms.txt > Use this file to discover all available pages before exploring further. # List automation runs > List safe run summaries for one configured Outlit automation. Read-only. ## OpenAPI ````yaml /openapi.json get /api/automations/{automationId}/runs openapi: 3.1.0 info: title: Outlit API summary: Public Outlit Platform and Ingest APIs. description: >- Canonical OpenAPI specification for the public Outlit API surfaces documented at docs.outlit.ai. version: 1.0.0 servers: - url: https://app.outlit.ai security: - bearerAuth: [] tags: - name: Platform API description: >- Authenticated API key routes for customer intelligence tools and integration management. - name: Ingest API description: Public-key event ingestion routes used by Outlit SDKs. paths: /api/automations/{automationId}/runs: get: tags: - Platform API summary: List automation runs description: List safe run summaries for one configured Outlit automation. Read-only. operationId: listAutomationRuns parameters: - name: automationId in: path required: true description: Automation ID. schema: type: string format: uuid - name: limit in: query required: false description: Maximum runs to return. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: cursor in: query required: false description: Pagination cursor from the previous response. schema: type: string responses: '200': description: Automation run summaries were returned. content: application/json: schema: $ref: '#/components/schemas/ListAutomationRunsCommandSuccess' '400': description: The query parameters failed command validation. content: application/json: schema: $ref: '#/components/schemas/CommandErrorEnvelope' '401': $ref: '#/components/responses/Unauthorized' '403': description: >- The API key is valid but does not have the required agent read scope. content: application/json: schema: $ref: '#/components/schemas/CommandErrorEnvelope' '404': description: >- No automation was found for the authenticated organization and requested automation ID. content: application/json: schema: $ref: '#/components/schemas/CommandErrorEnvelope' '500': $ref: '#/components/responses/InternalServerError' '503': description: The platform could not list automation runs. content: application/json: schema: $ref: '#/components/schemas/CommandErrorEnvelope' components: schemas: ListAutomationRunsCommandSuccess: type: object required: - ok - commandId - commandVersion - correlationId - result properties: ok: type: boolean const: true commandId: type: string const: automation.run.list commandVersion: type: integer const: 1 correlationId: type: string result: allOf: - $ref: '#/components/schemas/CommandResultBase' - type: object properties: operationId: type: string const: automation.run.list data: type: object required: - runs - pagination properties: runs: type: array items: $ref: '#/components/schemas/AutomationRunSummary' pagination: type: object required: - hasMore - nextCursor properties: hasMore: type: boolean nextCursor: type: - string - 'null' additionalProperties: false additionalProperties: false additionalProperties: false CommandErrorEnvelope: type: object required: - ok - commandId - commandVersion - error properties: ok: type: boolean const: false commandId: type: string commandVersion: type: integer minimum: 1 error: type: object required: - code - message - correlationId - retryable properties: code: type: string enum: - validation_failed - authorization_denied - conflict - not_found - rate_limited - transient_failure message: type: string correlationId: type: string retryable: type: boolean details: type: object additionalProperties: true additionalProperties: false additionalProperties: false CommandResultBase: type: object required: - operationId - status - resources - data - warnings properties: operationId: type: string status: type: string const: completed resources: type: array items: $ref: '#/components/schemas/CommandResource' data: type: object additionalProperties: true warnings: type: array items: type: string auditId: type: string additionalProperties: false AutomationRunSummary: type: object required: - id - automationId - triggerType - status - dedupeKey - eventProcessedId - eventName - eventChannel - eventOccurredAt - matchedAt - destinationCount - acceptedDestinationCount - failedDestinationCount - agentRunId - skipReason - errorCode - errorMessage - createdAt - updatedAt - deliveries - occurrences properties: id: type: string format: uuid automationId: type: string format: uuid triggerType: $ref: '#/components/schemas/AutomationTriggerType' status: $ref: '#/components/schemas/AutomationRunStatus' dedupeKey: type: - string - 'null' eventProcessedId: type: - string - 'null' eventName: type: - string - 'null' eventChannel: oneOf: - $ref: '#/components/schemas/EventChannel' - type: 'null' eventOccurredAt: type: - string - 'null' format: date-time matchedAt: type: string format: date-time destinationCount: type: integer minimum: 0 acceptedDestinationCount: type: integer minimum: 0 failedDestinationCount: type: integer minimum: 0 agentRunId: type: - string - 'null' skipReason: type: - string - 'null' errorCode: type: - string - 'null' errorMessage: type: - string - 'null' createdAt: type: string format: date-time updatedAt: type: string format: date-time deliveries: type: array items: $ref: '#/components/schemas/AutomationRunDeliverySummary' occurrences: type: array items: $ref: '#/components/schemas/AutomationRunOccurrenceSummary' additionalProperties: false ErrorResponse: type: object required: - error properties: error: type: string details: type: array items: $ref: '#/components/schemas/ValidationIssue' additionalProperties: true CommandResource: type: object required: - type - id properties: type: type: string id: type: string additionalProperties: false AutomationTriggerType: type: string enum: - SIGNAL_OCCURRENCE - SCHEDULE AutomationRunStatus: type: string enum: - PENDING - SKIPPED - RUNNING_PROCESSOR - READY_FOR_DELIVERY - PENDING_DELIVERY - DELIVERED - PARTIAL_FAILURE - FAILED EventChannel: type: string enum: - PRODUCT - COMMUNICATION - MEETING - CRM - BILLING - SUPPORT - IDENTITY - DOCUMENT - SYSTEM AutomationRunDeliverySummary: type: object required: - id - sourceType - sourceId - automationRunId - agentOutputId - destinationId - provider - providerEventId - status - queuedAt - enqueueAttemptCount - lastEnqueueAttemptAt - publishedAt - errorCode - errorMessage - createdAt - updatedAt properties: id: type: string format: uuid sourceType: type: string enum: - AUTOMATION_RUN - AGENT_OUTPUT sourceId: type: - string - 'null' automationRunId: type: - string - 'null' format: uuid agentOutputId: type: - string - 'null' format: uuid destinationId: type: string format: uuid provider: $ref: '#/components/schemas/DestinationProvider' providerEventId: type: - string - 'null' status: type: string enum: - PENDING_ENQUEUE - ENQUEUED - ACCEPTED_BY_PROVIDER - FAILED - SKIPPED queuedAt: type: - string - 'null' format: date-time enqueueAttemptCount: type: integer minimum: 0 lastEnqueueAttemptAt: type: - string - 'null' format: date-time publishedAt: type: - string - 'null' format: date-time errorCode: type: - string - 'null' errorMessage: type: - string - 'null' createdAt: type: string format: date-time updatedAt: type: string format: date-time additionalProperties: false AutomationRunOccurrenceSummary: type: object required: - id - signalId - grain - subjectType - subjectId - customerId - occurredAt - detectedAt - createdAt - updatedAt properties: id: type: string format: uuid signalId: type: string format: uuid grain: type: string enum: - ORGANIZATION - CUSTOMER - SEGMENT subjectType: type: string enum: - ORGANIZATION - CUSTOMER - SEGMENT subjectId: type: string customerId: type: - string - 'null' occurredAt: type: string format: date-time detectedAt: type: string format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time additionalProperties: false ValidationIssue: type: object required: - path - message properties: path: type: array items: type: - string - number message: type: string additionalProperties: false DestinationProvider: type: string enum: - SLACK - OUTPOST - WEBHOOK responses: Unauthorized: description: Invalid or missing API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Invalid credentials InternalServerError: description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: Outlit API key using the Bearer ok_... format. ````