Workflows

list_workflows

List workflows for the authenticated user's active team. Supports optional status filter and name search.

Input Schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "search": {
      "type": "string"
    },
    "status": {
      "enum": [
        "draft",
        "active",
        "archived"
      ],
      "type": "string"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "items",
    "itemsTotal"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Workflow UUID."
          },
          "name": {
            "type": "string"
          },
          "tags": {
            "type": "array"
          },
          "status": {
            "enum": [
              "draft",
              "active",
              "archived"
            ],
            "type": "string"
          },
          "link_url": {
            "type": "string",
            "format": "uri",
            "description": "Direct link to this workflow in MarketCore."
          },
          "created_at": {
            "type": "integer"
          },
          "updated_at": {
            "type": "integer"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    "curPage": {
      "type": "integer"
    },
    "nextPage": {
      "type": [
        "integer",
        "null"
      ]
    },
    "prevPage": {
      "type": [
        "integer",
        "null"
      ]
    },
    "itemsTotal": {
      "type": "integer"
    }
  }
}

Instructions

List workflows for the user's active team. Supports optional status filter and substring search.

Input roles:

status: "draft" | "active" | "archived". Omit to return all.
search: substring to match against workflow name.
page / per_page: pagination. Default page=1, per_page=20, max per_page=100.

Usage patterns:

Before create_workflow: call list_workflows with search: to check for duplicate-name workflows.
When the user asks "what workflows do I have": call with no filters.
When the user asks "what's my automation doing?": filter by status="active".