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

# List trigger invocation logs

> Unified history of trigger deliveries (connected app, direct webhook, scheduled poll). Scoped to the current project.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/trigger_instances/invocation-logs
openapi: 3.0.0
info:
  title: Flowra API (API Key Endpoints)
  description: >-
    **Flowra** is an AI-powered platform for building agents, workflows, and
    integrations.


    ### Capabilities

    - **Tools & Toolkits** – Define and group tools for agents and workflows.

    - **Workflows** – Orchestrate steps and automate processes.

    - **Triggers** – Schedule or event-based execution.

    - **Auth & Connections** – OAuth, API keys, and connected accounts.

    - **MCP** – Model Context Protocol server integration.

    - **Knowledge / RAG** – Add files and URLs for retrieval-augmented
    generation.


    ### Authentication

    Use the **x-api-key** header with a project API key to access endpoints that
    support API Key auth. Create and manage API keys in the dashboard under your
    project settings.


    Only endpoints that support API Key authentication via the @ApiKeyEnabled()
    decorator.


    Send x-api-key (required). On multi-tenant endpoints, optionally send
    x-username to act as an external user.
  version: '1.0'
  contact:
    name: Flowra
    url: https://flowra.dev
servers:
  - url: https://flowra.dev
    description: Flowra API
security: []
tags:
  - name: Users
    description: User profile
  - name: External Users
    description: End-user identities inside a project (x-username)
  - name: Auth Configs
    description: OAuth and API key configs for toolkits
  - name: Connected Accounts
    description: OAuth connected accounts and link creation
  - name: Toolkits
    description: List and search toolkits
  - name: Tools
    description: List, execute, and manage tools
  - name: Skills
    description: Browse, create, import, and install skills
  - name: Workflow & Agent
    description: Create, run, and inspect workflows and agents
  - name: Triggers
    description: Schedule and event-based trigger instances
  - name: Chat
    description: Threads and streaming agent runs
  - name: File
    description: Upload, list, and download files
  - name: Knowledge
    description: RAG knowledge collections
  - name: Table
    description: Collections and documents
  - name: Sandbox
    description: Ephemeral and durable code sandboxes
  - name: Browser
    description: Live browser sessions and view
  - name: LLM
    description: List AI models and generate completions
  - name: MCP
    description: MCP server management
  - name: usage
    description: Credit balance and usage ledger for the project API key
paths:
  /api/v1/trigger_instances/invocation-logs:
    get:
      tags:
        - Triggers
      summary: List trigger invocation logs
      description: >-
        Unified history of trigger deliveries (connected app, direct webhook,
        scheduled poll). Scoped to the current project.
      operationId: TriggersController_getTriggerInvocationLogs
      parameters:
        - name: q
          required: false
          in: query
          description: Search keyword for filtering results
          schema:
            example: john doe
            type: string
        - name: page
          required: false
          in: query
          description: Page number (1-based)
          schema:
            minimum: 1
            default: 1
            example: 1
            type: number
        - name: limit
          required: false
          in: query
          description: Number of items per page
          schema:
            minimum: 1
            maximum: 100
            default: 20
            example: 20
            type: number
        - name: offset
          required: false
          in: query
          description: Number of items to skip (for offset-based pagination)
          schema:
            minimum: 0
            example: 0
            type: number
        - name: sortBy
          required: false
          in: query
          description: Field name to sort by
          schema:
            example: createdAt
            type: string
        - name: sortOrder
          required: false
          in: query
          description: Sort order
          schema:
            default: DESC
            example: DESC
            enum:
              - ASC
              - DESC
            type: string
        - name: fields
          required: false
          in: query
          description: Comma-separated list of fields to include in response
          schema:
            example: id,name,email
            type: string
        - name: toolSlug
          required: false
          in: query
          description: Filter by trigger tool slug
          schema:
            example: slack_receive_message
            type: string
        - name: source
          required: false
          in: query
          description: Filter by how the invocation was received
          schema:
            enum:
              - connected_webhook
              - local_webhook
              - poll_scheduler
            type: string
        - name: triggerId
          required: false
          in: query
          description: Filter rows to a single trigger instance
          schema:
            format: uuid
            example: 550e8400-e29b-41d4-a716-446655440000
            type: string
        - name: x-username
          in: header
          required: false
          description: >-
            External user (end user) to act as. Optional — if omitted, Flowra
            uses the project’s default external user. Send a stable username
            (e.g. customer_alice) only when you need another end-user context.
          schema:
            type: string
            default: (project default user)
          example: customer_alice
      responses:
        '200':
          description: Operation completed successfully
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/TriggerInvocationLogListDtoPaginatedResponse
              example:
                success: true
                message: Data retrieved successfully
                data:
                  - id: ''
                    source: connected_webhook
                    sourceLabel: ''
                    toolSlug: ''
                    toolIconUrl: ''
                    triggerInstanceId: ''
                    connectedAccountId: ''
                    projectId: ''
                    euid: ''
                    payload: {}
                    workflowResults:
                      - workflowId: ''
                        workflowName: ''
                        success: true
                        error: ''
                    successful: true
                    error: ''
                    externalLogId: ''
                    metadata: {}
                    invokedAt: '2024-01-01T00:00:00.000Z'
                total: 100
                totalTools: 5000
                page: 1
                limit: 20
                totalPages: 5
                hasNextPage: true
                hasPreviousPage: false
      security:
        - x-api-key: []
        - x-api-key: []
          x-username: []
components:
  schemas:
    TriggerInvocationLogListDtoPaginatedResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Success status
          example: true
        message:
          type: string
          description: Response message
          example: Data retrieved successfully
        data:
          description: Array of items
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              source:
                enum:
                  - connected_webhook
                  - local_webhook
                  - poll_scheduler
                type: string
              sourceLabel:
                type: string
              toolSlug:
                type: string
              toolIconUrl:
                type: string
                nullable: true
              triggerInstanceId:
                type: string
                nullable: true
              connectedAccountId:
                type: string
                nullable: true
              projectId:
                type: string
                nullable: true
              euid:
                type: string
              payload:
                type: object
                nullable: true
                additionalProperties: true
                description: >-
                  Trigger event mapped onto the tool output schema (webhook
                  `data`). Transport envelope is not included.
              workflowResults:
                nullable: true
                type: array
                items:
                  type: object
                  properties:
                    workflowId:
                      type: string
                    workflowName:
                      type: string
                    success:
                      type: boolean
                    error:
                      type: string
                  required:
                    - workflowId
                    - success
              successful:
                type: boolean
              error:
                type: string
                nullable: true
              externalLogId:
                type: string
                nullable: true
                description: >-
                  Omitted on list responses so provider delivery ids are not
                  exposed.
              metadata:
                type: object
                nullable: true
                additionalProperties: true
                description: >-
                  Omitted on list responses; internal delivery bookkeeping is
                  not exposed.
              invokedAt:
                format: date-time
                type: string
            required:
              - id
              - source
              - sourceLabel
              - toolSlug
              - euid
              - successful
              - invokedAt
          example:
            - id: ''
              source: connected_webhook
              sourceLabel: ''
              toolSlug: ''
              toolIconUrl: ''
              triggerInstanceId: ''
              connectedAccountId: ''
              projectId: ''
              euid: ''
              payload: {}
              workflowResults:
                - workflowId: ''
                  workflowName: ''
                  success: true
                  error: ''
              successful: true
              error: ''
              externalLogId: ''
              metadata: {}
              invokedAt: '2024-01-01T00:00:00.000Z'
        total:
          type: number
          description: Total number of items across all pages
          example: 100
        totalTools:
          type: number
          description: >-
            Optional secondary total (e.g. nested tools across all matching
            toolkits)
          example: 5000
        page:
          type: number
          description: Current page number (1-based)
          example: 1
        limit:
          type: number
          description: Number of items per page
          example: 20
        totalPages:
          type: number
          description: Total number of pages
          example: 5
        hasNextPage:
          type: boolean
          description: Whether there is a next page
          example: true
        hasPreviousPage:
          type: boolean
          description: Whether there is a previous page
          example: false
      required:
        - success
        - message
        - data
        - total
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Project API key. Create and manage keys in the dashboard under Project →
        API Keys. Send as header: x-api-key: <your-key>
    x-username:
      type: apiKey
      in: header
      name: x-username
      description: >-
        Optional. External user username. If omitted, Flowra uses the project’s
        default external user. Send as header: x-username: <username>

````

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