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

# List workflows

> Returns a page of the environment's workflows with the IDs the other workflow operations take. A workflow is a graph of blocks and steps the agent can run; send `nextCursor` as `cursor` for the next page.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json get /v1/stable/workflow
openapi: 3.0.0
info:
  title: Realtime
  description: Realtime gateway API service
  version: 1.0.0
  contact: {}
servers:
  - url: https://realtime-api.voiceflow.com
security: []
tags: []
paths:
  /v1/stable/workflow:
    get:
      tags:
        - Workflow
      summary: List workflows
      description: Returns a page of the environment's workflows with the IDs the
        other workflow operations take. A workflow is a graph of blocks and
        steps the agent can run; send `nextCursor` as `cursor` for the next
        page.
      operationId: StableWorkflowController_list
      parameters:
        - name: projectID
          required: true
          in: query
          schema:
            type: string
            description: The ID of the project to operate on.
        - name: environmentAlias
          required: true
          in: query
          schema:
            type: string
            description: The alias of the environment to operate on (e.g. `main`).
        - name: folderID
          required: false
          in: query
          schema:
            description: Only the workflows in this folder.
            type: string
        - name: cursor
          required: false
          in: query
          schema:
            description: The nextCursor of the previous page. Leave it out for the first
              page. Pages are counted on the workflows as they are at each call,
              so an edit between pages can repeat or skip a workflow.
            type: string
            pattern: ^\d+$
        - name: limit
          required: false
          in: query
          schema:
            description: The most workflows to return. Defaults to 50.
            type: integer
            minimum: 1
            maximum: 50
      responses:
        "200":
          description: Returns a page of workflows with each one's ID, name, description,
            folder and last update time. When more follow, `nextCursor` holds
            the value to send as `cursor` for the next page.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StableWorkflowReadListResponse"
          x-vf-doc:
            description: Returns a page of workflows with each one's ID, name, description,
              folder and last update time. When more follow, `nextCursor` holds
              the value to send as `cursor` for the next page.
      security:
        - token: []
components:
  schemas:
    StableWorkflowReadListResponse:
      type: object
      properties:
        workflows:
          type: array
          items:
            $ref: "#/components/schemas/StableWorkflowSummary"
          description: Oldest first.
        nextCursor:
          description: Present when more workflows follow. Send it as cursor.
          type: string
      required:
        - workflows
    StableWorkflowSummary:
      type: object
      properties:
        id:
          type: string
          description: The workflow ID that every workflow operation, a Workflow step and
            a Go to block take.
        name:
          type: string
        description:
          nullable: true
          type: string
        folderID:
          nullable: true
          type: string
        updatedAt:
          type: string
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
      required:
        - id
        - name
        - description
        - folderID
        - updatedAt
  securitySchemes:
    token:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Voiceflow bearer token
````
