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

# List flows



## OpenAPI

````yaml /openapi.yaml get /v1/flows
openapi: 3.1.0
info:
  title: Milford HTTP API
  version: 0.0.1
  description: >
    Run flows, list them, and receive signed webhooks. The server is stateless
    and has no database.

    Generate a client for your language from this file with any OpenAPI
    generator.
servers:
  - url: http://localhost:8080
security:
  - bearer: []
paths:
  /v1/flows:
    get:
      summary: List flows
      operationId: listFlows
      responses:
        '200':
          description: The flows loaded at startup.
          content:
            application/json:
              schema:
                type: object
                required:
                  - flows
                properties:
                  flows:
                    type: array
                    items:
                      $ref: '#/components/schemas/FlowSummary'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    FlowSummary:
      type: object
      required:
        - id
        - nodes
      properties:
        id:
          type: string
        nodes:
          type: integer
          description: Number of nodes in the flow.
        description:
          type: string
          description: What the flow does.
        input:
          type: object
          description: JSON Schema of the run input, when the flow declares one.
          additionalProperties: true
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
  responses:
    Unauthorized:
      description: The bearer token is missing or wrong.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: One of `server.auth.tokens`. With no tokens configured the API is open.

````

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