How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Ironclad Workflows API

Documentation on Ironclad Workflows.

Ironclad Workflows API is one of 13 APIs that Ironclad publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 5 JSON Schema definitions.

Tagged areas include Workflows. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, rate-limit docs, a JSON-LD context, and 5 JSON Schemas.

This API exposes 43 operations across 38 paths, and defines 56 schemas. It is described by OpenAPI 3.2.0, at version 1.

Requests are made against 3 base URLs: https://na1.ironcladapp.com/oauth, https://eu1.ironcladapp.com/oauth, https://demo.ironcladapp.com/oauth.

43 operations 38 paths 56 schemas 2 DELETE19 GET7 PATCH15 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1
Base URL
https://na1.ironcladapp.com/public/api/v1
Resource Areas
1

Paths & Operations 43

Across 38 paths, the API surfaces 43 operations — 2 DELETE, 19 GET, 7 PATCH, 15 POST. Each is listed below with its method, path, parameters, and response codes.

Workflows 43

Documentation on Ironclad Workflows.

POST
/workflows
Create a Workflow Synchronously
launch-a-new-workflow 3 params body → 200400
GET
/workflows
List All Workflows
list-all-workflows 9 params → 200
POST
/workflows/async
Create a Workflow Asynchronously
create-a-new-workflow-async 3 params body → 200400
GET
/workflows/async/{asyncJobId}
Retrieve the Status of an Async Workflow Create Job
retrieve-asynchronous-workflow-status 3 params → 200404
GET
/workflows/{id}
Retrieve a Workflow
retrieve-a-workflow 4 params → 200400
GET
/workflows/{id}/approvals
List All Workflow Approvals
list-all-workflow-approvals 3 params → 200400
GET
/workflows/{id}/approval-requests
Retrieve the Approval Requests on a Workflow
approval-requests 7 params → 200403404
PATCH
/workflows/{id}/approvals/{roleId}
Update Approval Status on a Workflow
update-workflow-approval 4 params body → 200400
GET
/workflows/{id}/turn-history
Retrieve the Turn History on a Workflow
turn-history 5 params → 200403404
GET
/workflows/{id}/sign-status
Retrieve Sign Step Status
get-sign-status 3 params → 200400401403404
POST
/workflows/{id}/sign-status/send-signature-request
Send Signature Request
send-signature-request 3 params → 200400401404
POST
/workflows/{id}/sign-status/scheduled-send
Schedule Send Signature Request
schedule-send-signature-request 3 params body → 200400401404
PATCH
/workflows/{id}/sign-status/scheduled-send
Update Scheduled Signature Request
update-scheduled-signature-request 3 params body → 200400401404
DELETE
/workflows/{id}/sign-status/scheduled-send
Delete Scheduled Signature Request
delete-scheduled-signature-request 3 params → 200400401404
POST
/workflows/{id}/sign-status/cancel-signature-request
Cancel Signature Request
cancel-signature-request 3 params body → 200400401404
PATCH
/workflows/{id}/sign-status/signers/{signerRoleName}
Update Signer
update-signer 4 params body → 200400401404
DELETE
/workflows/{id}/sign-status/signers/{signerRoleName}
Delete Signer
delete-signer 4 params → 204400401404
POST
/workflows/{id}/sign-status/signers/{signerRoleName}/remind
Remind Signer
remind-signer 4 params → 204400401404429
GET
/workflows/{id}/signatures
List All Workflow Signers
list-all-workflow-signers 3 params → 200400403
POST
/workflows/{id}/signatures/recipient-urls
Create a Recipient URL for a Signer
create-recipient-url 3 params body → 201400401403404429
POST
/workflows/{id}/signatures/recipient-urls/embedded
Create an Embeddable Recipient URL for a Signer
create-embeddable-recipient-url 3 params body → 201400401403404429
POST
/workflows/{id}/upload-signed
Create a Signed Document on a Workflow
workflow-upload-signed-document 3 params body → 200400404
GET
/workflows/{id}/participants
List All Workflow Participants
list-all-workflow-participants 6 params → 200403404
PATCH
/workflows/{id}/roles/{roleName}
Update Workflow Role Assignment
update-workflow-role-assignment 4 params body → 200400403404422
GET
/workflows/{id}/roles/{roleName}/eligible-assignees
List Eligible Assignees for a Workflow Role
list-workflow-role-eligible-assignees 6 params → 200404
PATCH
/workflows/{id}/revert-to-review
Revert a Workflow to the Review Step
revert-to-review 3 params body → 204400403404
POST
/workflows/{id}/cancel
Cancel a Workflow
cancel-a-workflow 3 params body → 204
POST
/workflows/{id}/pause
Pause a Workflow
pause-a-workflow 3 params body → 204400
POST
/workflows/{id}/resume
Resume a Workflow
resume-a-workflow 3 params body → 204400
POST
/workflows/{id}/commentdeprecated
Create a Comment on a Workflow
deprecated-create-a-comment-on-a-workflow 3 params body → 204400
POST
/workflows/{id}/comments
Create a Comment on a Workflow
create-a-comment-on-a-workflow 3 params body → 200400
GET
/workflows/{id}/comments
List all Comments on a Workflow
list-all-comments-in-a-workflow 5 params → 200403404
GET
/workflows/{id}/comments/{commentId}
List a Comment from a Specified Workflow
list-a-comment-from-a-workflow 4 params → 200403404
PATCH
/workflows/{id}/attributes
Update Workflow Metadata
update-workflow-metadata 3 params body → 200400403404
GET
/workflows/{id}/documents
Retrieve Documents from a Workflow
retrieve-workflow-documents 3 params → 200401403404
PATCH
/workflows/{id}/signature-packet
Update Signature Packet on a Workflow
update-workflow-signature-packet 3 params body → 200400401403404
POST
/workflows/{id}/documents/{attributeId}
Create a Document on a Workflow
create-a-workflow-document 4 params body → 204400404
GET
/workflows/{id}/document/{key}/download
Retrieve a Workflow Document
retrieve-a-workflow-document 4 params → 200400
GET
/workflows/{id}/emails
Retrieve Email Threads from A Workflow
retrieve-email-threads-from-workflow 5 params → 200404
GET
/workflows/{id}/emails/{emailThreadId}
Retrieve an Email Thread from a Specified Workflow
retrieve-email-thread-from-workflow 4 params → 200404
GET
/workflows/{id}/emails/{emailThreadId}/attachments/{attachmentId}
Retrieve an Attachment from an Email Thread
retrieve-attachment-from-email-thread 5 params → 200404
GET
/workflow-schemas
List All Workflow Schemas
list-all-workflow-schemas 3 params → 200400
GET
/workflow-schemas/{id}
Retrieve a Workflow Schema
retrieve-a-workflow-schema 4 params → 200400

Schemas 56

The contract defines 56 schemas that model the data the API accepts and returns. The most detailed are WorkflowResponseModel (18 properties), LaunchedWorkflow (18 properties), OutboundActivityFeedEmail (10 properties), ActivityFeedComment (9 properties). Each schema is shown below with its type and property counts.

CreatorEmailModel
object
The Ironclad user (must be a user in your Ironclad account) used to launch the workflow by using the user's email address.
2 properties
EmailNotFound
object
Email ID Not Found Request Error
3 properties
InternalAssignment
object
2 properties 2 required
WorkflowRoleModel
object
3 properties
CreatorIdModel
object
The Ironclad user (must be a user in your Ironclad account) used to launch the workflow by using the user's ID.
2 properties
OutboundActivityFeedEmail
object
An outbound email-type item on the workflow activity feed
10 properties 4 required
WorkflowSchemasChildRecordAttribute
object
A child record schema attribute. The referenced record must not already have a parent.
4 properties
SignedDocumentResponseModel
object
WorkflowAsyncLaunchFailedResponse
object
3 properties 3 required
SignedResponse200
object
3 properties
SignStatusInternalSigner
AttributeNumberModel
number
WorkflowSchemasParentRecordAttribute
object
A parent record schema attribute.
4 properties
AttributesModel
object
The data that will be used to populate the workflow's fields. Learn more about the various attributes and their associated types by viewing the [Launch a Workf…
6 properties 1 required
WorkflowSchemasResponseOptionsField
object
Defines the options for a field, including dropdown choices and whether free text input is allowed.
2 properties 2 required
ParentRecordAttributeModel
object
A parent record attribute value. Contains the record ID and readable ID of the parent record.
2 properties
AttributeStringModel
string
WorkflowAsyncInProgressResponse
object
2 properties 2 required
LaunchedWorkflow
object
The response from a successful workflow launch.
18 properties 15 required
AddUsersToWorkflowModel
boolean
Must be set to true if mentioning users who are not participants on the workflow.
AttachmentNotFound
object
attachmentId Not Found Request Error
3 properties
WorkflowNotFound
object
Workflow ID Not Found Request Error
3 properties
CreatorModel
object
The Ironclad user (must be a user in your Ironclad account) to be used for launching the workflow. This is required when using a legacy bearer token but will b…
FileUploadModel
WorkflowSchemasLinkedRecordAttribute
object
A linked record schema attribute.
4 properties
NotOnSignStep400
object
2 properties
OutboundEmailAttachment
object
An attachment on an outbound email
5 properties 3 required
ActivityFeedAuthor
object
The author of an activity feed item
WorkflowResponseModel
object
The response from a successful workflow retrieval.
18 properties 15 required
WorkflowTemplateIdModel
string
The identifier of the workflow template
BadRequestErrorWorkflowLaunch
object
3 properties 3 required
WorkflowRoleAssigneeModel
object
3 properties
WorkflowLaunchMultipartModel
object
Note that creator is required when launching with a legacy bearer token but will be ignored when launching via an OAuth token. If the token was generated with…
1 property
InboundActivityFeedEmail
object
An inbound email-type item on the workflow activity feed
8 properties 5 required
BaseSignStatusSigner
object
7 properties 4 required
ActivityFeedEmail
object
A email-type item on the workflow activity feed
InboundEmailAttachment
object
An attachment on an inbound email
5 properties 2 required
SystemActivityFeedAuthor
object
A system author of an activity feed item
2 properties 2 required
SignStatusModel
object
6 properties
WorkflowSchemasResponseDefaultField
Defines the available default value for a field. In the case of multiple instances of the same property, the last evaluated default will be used.
WorkflowLaunchModel
object
Note that creator is required when launching with a legacy bearer token but will be ignored when launching via an OAuth token. If the token was generated with…
3 properties 2 required
SignatureStatusModel
object
1 property
WorkflowAsyncLaunchSuccessResponse
object
Response for a successfully asynchronously launched workflow.
4 properties 4 required
LinkedRecordAttributeModel
object
A linked record attribute value. Contains the record ID and readable ID of the linked record.
2 properties
IntegrationActivityFeedAuthor
object
An integration author of an activity feed item
2 properties 2 required
WorkflowStateModel
object
SignStatusExternalSigner
InternalActivityFeedAuthor
object
An internal author of an activity feed item
5 properties 2 required
CommentModel
object
2 properties 1 required
ActivityFeedComment
object
A comment-type item on the workflow activity feed
9 properties 7 required
WorkflowDocumentModel
object
6 properties 5 required
WorkflowSchemasResponseRequiredField
string
Indicates whether the field is required. Possible values are 'always', 'never', or 'conditional'. Conditional properties are either gated by a condition on the…
ChildRecordAttributeModel
object
A child record attribute value. Contains the record ID and readable ID of the child record.
2 properties
PartialSignedResponse200
object
4 properties
ExternalActivityFeedAuthor
object
An external author of an activity feed item (typically a counterparty)
4 properties 2 required
ExternalAssignment
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ironclad-workflows-api-openapi.yml Raw ↑

Other APIs Ironclad publishes across the network.

Ironclad Clickwrap API
Ironclad Authorization API
Ironclad Entities API
Ironclad Exports API
Ironclad Groups API
Ironclad Obligations API
Ironclad Records API
Ironclad Resources API
Ironclad Schemas API
Ironclad Search API
Ironclad Users API
Ironclad Webhooks API
Where this information came from

This is an independent, third-party profile of Ironclad Workflows API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.