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

# Get workflows

> List advanced (graph) workflows the API key can access, paginated. Filter by name search, trigger type, or published state.

Responses include direct Enginy app URLs when available. Each item includes an `appUrl` that opens the workflow editor. MCP agents should return those URLs to users whenever they are present in the response.

    > **Required scope:** `WORKFLOWS_READ`
    >
    > **Rate limit:** 100 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json get /v1/workflows
openapi: 3.1.0
info:
  title: Enginy API
  version: 1.0.0
  description: Public API for Enginy platform
servers:
  - url: https://openapi.enginy.ai
    description: Configured server
security: []
tags:
  - name: AI Variables
    description: >-
      Manage AI variables and discover the entity fields you can reference in
      prompts and entity requests.
  - name: Inbox
    description: >-
      Inbox endpoints for listing contact threads, reading thread messages,
      managing tags, and sending manual replies.
  - name: Workflows
    description: >-
      Build, validate, publish, run, and inspect advanced (graph) workflows,
      plus the block/condition catalog needed to author a workflow plan.
paths:
  /v1/workflows:
    get:
      tags:
        - Workflows
      summary: Get workflows
      description: >-
        List advanced (graph) workflows the API key can access, paginated.
        Filter by name search, trigger type, or published state.


        Responses include direct Enginy app URLs when available. Each item
        includes an `appUrl` that opens the workflow editor. MCP agents should
        return those URLs to users whenever they are present in the response.

            > **Required scope:** `WORKFLOWS_READ`
            >
            > **Rate limit:** 100 requests per minute
      parameters:
        - schema:
            type: string
            description: Case-insensitive match on workflow name.
          required: false
          description: Case-insensitive match on workflow name.
          name: search
          in: query
        - schema:
            type: string
            enum:
              - MANUAL
              - WEBHOOK
              - API
              - SCHEDULE
              - INTENT
            description: Filter by configured trigger type.
          required: false
          description: Filter by configured trigger type.
          name: triggerType
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: Filter by published state.
          required: false
          description: Filter by published state.
          name: isPublished
          in: query
        - schema:
            type: string
            description: 1-based page number (default 1).
          required: false
          description: 1-based page number (default 1).
          name: page
          in: query
        - schema:
            type: string
            description: Page size (default 25, max 100).
          required: false
          description: Page size (default 25, max 100).
          name: pageSize
          in: query
      responses:
        '200':
          description: Workflows retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                        name:
                          type: string
                        appUrl:
                          type: string
                          format: uri
                        isPublished:
                          type: boolean
                        hasUnpublishedChanges:
                          type: boolean
                        triggerType:
                          type: string
                        folderId:
                          type:
                            - number
                            - 'null'
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                      required:
                        - id
                        - name
                        - appUrl
                        - isPublished
                        - hasUnpublishedChanges
                        - triggerType
                        - folderId
                        - createdAt
                        - updatedAt
                  meta:
                    type: object
                    properties:
                      page:
                        type: number
                      pageSize:
                        type: number
                      total:
                        type: number
                    required:
                      - page
                      - pageSize
                      - total
                required:
                  - data
                  - meta
        '400':
          description: Invalid workflow list filter.
        '403':
          description: >-
            Advanced workflows are not enabled for this workspace. Ask your
            workspace admin to enable the feature.
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````