View as Markdown
Ironclad icon

Ironclad ACTION

Search Workflows

Searches Ironclad workflows using structured filters and/or Ironclad's native formula filter language. Use this to find a workflow's ID before Get Workflow or Update Workflow Attributes. The filter formula operates on attribute keys in [brackets] — run Describe Workspace first to see valid attribute keys. Formula operators: Equals([attr], 'value'), NotEqual([attr], 'value'), Contains([attr], 'value'), IsEmpty([attr]), IsNotEmpty([attr]), LessThan([attr], value) / LessThanOrEqual([attr], value), GreaterThan([attr], value) / GreaterThanOrEqual([attr], value), Date(2026, 1, 1) (year, month, day), Today(), RelativeDate(Today(), -7, 'days') (anchor - Today() or Date(...) -, offset, unit; unit is one of days, weeks, months, years), And(cond1, cond2, ...), Or(cond1, cond2, ...). String values support both single and double quotes. Worked examples: find by counterparty name Contains([counterpartyName], 'Acme'); find workflows with an agreement date in the last week GreaterThan([agreementDate], RelativeDate(Today(), -7, 'days')); find workflows missing a signed copy IsEmpty([signedCopy]). Status and template are not formula-filterable properties — to find cancelled or completed workflows, set the status prop to cancelled,completed; to find workflows launched from a specific template, set the template prop instead of using filter. Example: set status to "active" and pageSize to 5 to retrieve the 5 most recently updated active workflows; returns {"list": [{"id": "wf_xyz789", "title": "Acme NDA", "status": "active"}], "count": 1}. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Ironclad account once, then configure and run Search Workflows from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "ironclad-search-workflows",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    ironclad: { authProvisionId: "apn_xxxxxxx" },
    filter: "Filter",
    status: "Status",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Workflows inputs
Property Type Description
filter Filter string
Ironclad formula filter expression, e.g. Contains([counterpartyName], 'Acme'). See the tool description for the full operator list and worked examples. Optional — omit to list workflows without a formula filter.
Optional
status Status string
Restrict results to workflows with this status. Valid values: active, paused, completed, cancelled. To match multiple statuses, pass a comma-separated list, e.g. cancelled,completed.
Optional
template Template string
Restrict results to workflows launched from this template ID. Obtain via Describe Workspace.
Optional Dynamic
lastUpdated Last Updated Since string
ISO 8601 date-time — restrict results to workflows updated at or after this timestamp, e.g. 2026-01-01T00:00:00Z.
Optional
page Page integer
0-indexed page of results. Increment and call again if count suggests more results than were returned.
Optional
pageSize Page Size integer
Number of results per page. Defaults to Ironclad's standard page size if omitted.
Optional
hydrateEntities Hydrate Entities boolean
Whether to expand referenced entities in each result. Defaults to false.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
ironclad-search-workflows
Version
0.0.2
App
Ironclad
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes