> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Ironclad

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List workflows waiting on legal review and how long each has been open
* Find executed contracts with `Acme Corp` that renew in the next 90 days
* Launch an NDA workflow for counterparty `Globex Inc`

## Available Tools

#### create_record

Create a repository record (a contract file with metadata properties). Get valid `type` and `properties` keys from ge...

#### create_webhook

Subscribe a target URL to Ironclad events, e.g. events=\['workflow_launched'] or \['\*'] for all (not recommended at hig...

#### create_workflow

Launch a new Ironclad workflow from a template. Discover the `template` ID and required `attributes` keys with list_w\...

#### create_workflow_comment

Post a comment on a workflow's activity feed. @-mention a user as @[john.doe@example.com](mailto:john.doe@example.com). The author is the user the t...

#### delete_record

Permanently delete a repository record. Use list_records to find the record_id.

#### delete_webhook

Delete a webhook subscription. Use list_webhooks to find the webhook_id.

#### get_record

Retrieve one repository record by ID - type, properties, attachments, links, contract status. Use list_records to fin...

#### get_records_metadata

Get the record-type catalog and property schema for the Ironclad repository - the valid `type` values and \`properties...

#### get_webhook

Retrieve one webhook subscription by ID. Use list_webhooks to find IDs.

#### get_webhook_verification_key

Get Ironclad's public key (PEM) for verifying signatures on inbound webhook payloads at your target URL.

#### get_workflow

Retrieve one workflow by ID - step, status, attributes, creator, record links. Use list_workflows to find IDs; for ap...

#### get_workflow_approvals

Get a workflow's approval state - approval groups, reviewer statuses and role assignments. Use list_workflows to find...

#### get_workflow_comment

Retrieve one comment on a workflow by ID. Use list_workflow_comments to find comment IDs.

#### get_workflow_schema

Retrieve one workflow template by ID, including its full attribute schema. Use list_workflow_schemas to find IDs.

#### list_records

List Ironclad repository records, filterable by record type, free-text search, last-updated time and formula filter...

#### list_webhooks

List Ironclad webhook subscriptions - event lists, target URLs and enabled/disabled status. Use this to find the webh...

#### list_workflow_comments

List comments on a workflow's activity feed (newest activity, author, mentions). Use list_workflows to find the workf...

#### list_workflow_participants

List the users participating on a workflow (userId + email). Use list_workflows to find the workflow_id.

#### list_workflow_schemas

List Ironclad workflow templates (launch forms). The returned `id` is the `template` create_workflow requires, and ea...

#### list_workflow_turn_history

List a workflow's turn history - who held the pen (internal vs counterparty) and when. Use list_workflows to find the...

#### list_workflows

List Ironclad workflows, filterable by status, template, free-text search, formula filter and last-updated time. Use...

#### replace_record

Replace a record's writable fields wholesale (PUT semantics - the property map is replaced, not merged). Prefer updat...

#### update_record

Patch a record - rename, retype, add/overwrite or remove properties (addProperties/removeProperties keyed by property...

#### update_webhook

Update a webhook's events, target URL or enabled/disabled status. Use list_webhooks to find the webhook_id.

#### update_workflow_attributes

Patch attributes on an in-flight workflow (set/remove values by attribute ID - the `path` key on each update). Attrib...