list_workflows
List the team's workflows, with optional status filter and name search. Use it to see existing workflows or to check for duplicate names before creating one.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "1-based page number through the list, which is ordered newest first. Defaults to 1; only needed when the team has more workflows than a single page holds."
},
"search": {
"type": "string",
"description": "Case-insensitive substring match against the workflow name only — it does not look at descriptions, steps or tags. Use it before creating a workflow to check the team does not already have one with a similar name."
},
"status": {
"type": "string",
"description": "Restricts results to workflows in one exact state: \"draft\", \"active\" or \"archived\". Omit to return every workflow for the user's current team. Use \"active\" when the user asks what automations are actually able to run."
},
"per_page": {
"type": "integer",
"description": "How many workflows to return per page. Defaults to 20 when omitted or when the value is not a positive number."
}
}
}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
