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

# List Conversation Workflow Logs

> Retrieves a paginated list of conversation workflow execution logs. Supports filtering by date range, conversation UUIDs, and success status.



## OpenAPI

````yaml get /conversations/workflow-logs
openapi: 3.0.1
info:
  title: Attention Service V2
  description: Attention Service API V2
  termsOfService: https://www.attention.com/terms-of-use
  contact:
    name: Attention Team
    url: https://docs.attention.com/welcome
    email: support@attention.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.8.0
servers:
  - url: https://api.attention.tech/v2
security:
  - APIKeyHeader: []
paths:
  /conversations/workflow-logs:
    get:
      tags:
        - Conversation
      summary: List Conversation Workflow Logs
      description: >-
        Retrieves a paginated list of conversation workflow execution logs.
        Supports filtering by date range, conversation UUIDs, and success
        status.
      operationId: listConversationWorkflowLogs
      parameters:
        - name: fromDateTime
          in: query
          description: Start date and time for filtering logs (ISO 8601 format)
          schema:
            type: string
            format: date-time
        - name: toDateTime
          in: query
          description: End date and time for filtering logs (ISO 8601 format)
          schema:
            type: string
            format: date-time
        - name: conversationUUIDs
          in: query
          description: Filter logs by specific conversation UUIDs
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - name: success
          in: query
          description: >-
            Filter logs by success status (true for successful, false for
            failed)
          schema:
            type: boolean
        - name: limit
          in: query
          description: 'Maximum number of logs to return (default: 100, max: 1000)'
          schema:
            type: integer
        - name: offset
          in: query
          description: Number of logs to skip for pagination
          schema:
            type: integer
      responses:
        '200':
          description: Successfully retrieved workflow logs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationWorkflowLogsResponse'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ConversationWorkflowLogsResponse'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication failed - valid API key required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error occurred while processing the request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ConversationWorkflowLogsResponse:
      type: object
      properties:
        data:
          type: array
          description: List of conversation workflow logs
          items:
            $ref: '#/components/schemas/ConversationWorkflowLog'
        total:
          type: integer
          description: Total number of logs matching the filter criteria
          format: int64
      example:
        data:
          - conversationUUID: conv-uuid-123
            workflowName: crm_export
            success: true
            error: ''
            createdAt: '2024-03-18T14:35:00Z'
          - conversationUUID: conv-uuid-123
            workflowName: scorecard_calculation
            success: false
            error: Scorecard template not found
            createdAt: '2024-03-18T14:40:00Z'
        total: 2
    Error:
      type: object
      properties:
        id:
          type: string
          description: A unique identifier for the error.
        status:
          type: string
          description: >-
            The HTTP status code applicable to this problem, expressed as a
            string value.
        code:
          type: string
          description: An application-specific error code, expressed as a string value.
        title:
          type: string
          description: A short, human-readable summary of the problem.
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
        source:
          type: object
          properties:
            pointer:
              type: string
            parameter:
              type: string
        meta:
          type: object
          properties: {}
      example:
        id: not_found_error
        status: '404'
        code: '404'
        title: Not Found Error
        detail: The requested resource was not found
        source:
          pointer: /data/attributes/id
    ConversationWorkflowLog:
      type: object
      properties:
        conversationUUID:
          type: string
          description: UUID of the conversation
        createdAt:
          type: string
          description: Timestamp when the workflow was executed
          format: date-time
        workflowName:
          type: string
          description: Name of the workflow that was executed
        success:
          type: boolean
          description: Whether the workflow execution was successful
        error:
          type: string
          description: Error message if the workflow execution failed
      example:
        conversationUUID: conv-uuid-123
        workflowName: crm_export
        success: true
        error: ''
        createdAt: '2024-03-18T14:35:00Z'
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      name: Authorization
      in: header

````