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 ID. Use as workflow_id in get_workflow, update_workflow, run_workflow, and get_workflow_runs."
          },
          "name": {
            "type": "string"
          },
          "status": {
            "enum": [
              "draft",
              "active",
              "archived"
            ],
            "type": "string"
          },
          "link_url": {
            "type": "string",
            "format": "uri",
            "description": "Direct URL to view the workflow in Marcora."
          }
        }
      }
    },
    "curPage": {
      "type": "integer"
    },
    "nextPage": {
      "type": [
        "integer",
        "null"
      ]
    },
    "prevPage": {
      "type": [
        "integer",
        "null"
      ]
    },
    "itemsTotal": {
      "type": "integer"
    }
  }
}

Instructions

List workflows for your active team. Supports an optional status filter and a name substring search. Call this before create_workflow to check for duplicate names.

Parameters:

status (string, optional): Filter by status: draft, active, or archived. Omit to return all
search (string, optional): Substring match against workflow name
page (integer, optional): Page number (default 1)
per_page (integer, optional): Items per page (default 20, max 100)

Output: A paginated object.

items (array): Array of workflow summaries. Each item: id (uuid — use as workflow_id in get_workflow, update_workflow, run_workflow, and get_workflow_runs), name, status (draft/active/archived), link_url
itemsTotal (integer): Total number of matching workflows
curPage (integer): Current page
nextPage (integer or null): Next page number, or null if last page
prevPage (integer or null): Previous page number, or null if first page