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

Docusign WorkflowManagement API

Returns the history of the workflow instance steps.

Docusign WorkflowManagement API is one of 134 APIs that Docusign publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Workflow Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, a getting-started guide, rate-limit docs, and 1 JSON Schema.

This API exposes 7 operations across 4 paths, and defines 32 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://apps.docusign.com/api/maestro.

7 operations 4 paths 32 schemas 1 DELETE3 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://demo.docusign.net/restapi
Authentication
OAuth 2.0, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

Docusign WorkflowManagement API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (DSAuth) using the authorizationCode flow, exposing 2 scopes. An API key is passed in the header as Authorization (DSBearerAuth).

  • DSAuth — Docusign AuthN/AuthZ

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 3 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

WorkflowManagement 7

Returns the history of the workflow instance steps.

GET
/v1/accounts/{accountId}/management/instances/{instanceId}/history
Docusign Gets the step history for a workflow instance.
getWorkflowHistory 2 params → 200401403404500
GET
/v1/accounts/{accountId}/management/workflow_definitions
Docusign Gets a list of workflow definition metadata.
getWorkflowDefinitions 2 params → 200400401403500
POST
/v1/accounts/{accountId}/management/workflow_definitions
Docusign Creates a workflow definition.
createNewWorkflowDefinition 1 param body → 200401404500
GET
/v1/accounts/{accountId}/management/workflow_definitions/{workflowDefinitionId}
Docusign Gets a workflow definition.
getWorkflowDefinition 3 params → 200400401403500
PUT
/v1/accounts/{accountId}/management/workflow_definitions/{workflowDefinitionId}
Docusign Updates a workflow definition.
updateWorkflowDefinition 2 params body → 200400401404500
DELETE
/v1/accounts/{accountId}/management/workflow_definitions/{workflowDefinitionId}
Docusign Deletes a workflow definition.
deleteWorkflowDefinition 2 params → 200404500
POST
/v1/accounts/{accountId}/management/workflow_definitions/{workflowDefinitionId}/publish
Docusign Publishes or unpublishes a workflow definition.
publishOrUnPublishWorkflowDefinition 2 params body → 200400401404500

Schemas 32

The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are WorkflowDefinitionWithId (12 properties), WorkflowStepHistory (11 properties), WorkflowDefinitionMetadata (10 properties), WorkflowDefinition (10 properties). Each schema is shown below with its type and property counts.

WorkflowInstanceId
string
Workflow instance ID. A string in UUID format: 4a6d6a08-xxxx-xxxx-xxxx-bae4fecc99c8
ErrorResponse
object
Returns error with a status message
2 properties
ValidationErrors
object
2 properties 2 required
CreateOrUpdateWorkflowDefinitionRequestBody
object
Request body to create or update a workflow definition.
1 property
WorkflowDefinition
object
A Maestro workflow definition.
10 properties 8 required
LastDeployedId
string
Participant
object
A Maestro workflow [participant](/docs/maestro-api/maestro101/participants/).
4 properties 4 required
DSWorkflowTrigger
object
A Maestro workflow trigger.
7 properties 6 required
InvalidWorkflowResponse
object
2 properties 2 required
WorkflowStepHistory
object
Details (history) of a workflow instance step.
11 properties 4 required
DsStepId
string
DS Step Id
DSWorkflowTriggerTypes
string
The DS Workflow Trigger types
WorkflowDefinitionWithId
object
A Maestro workflow definition with metadata.
12 properties 1 required
DeployResponse
object
4 properties 2 required
WorkflowDefinitionList
object
Returns a list of workflow definitions' metadata (0 or more).
2 properties
ErrorCodes
string
Internal Error Codes
WorkflowDeleteResponse
object
The response to a request to delete a workflow.
2 properties 2 required
WorkflowMetadataStatus
string
Workflow definition metadata status.
DeployStatus
string
HttpTypes
string
The Trigger Http types
WorkflowDateTime
string
A date-time string.
AowUUIDString
string
A string in UUID format: 4a6d6a08-xxxx-xxxx-xxxx-bae4fecc99c8
DeployRequest
object
1 property 1 required
NewOrUpdatedWorkflowDefinitionResponse
object
4 properties 4 required
AowUUID
string
VersionString
string
A string in version number format: 3.14.159
WorkflowDefinitionMetadata
object
A Maestro workflow definition's metadata.
10 properties 1 required
WorkflowStepError
object
Workflow step history error
5 properties
AccountId
string
Account Id
EventTypes
string
The Trigger Event types
UserId
string
Participant User ID
WorkflowStepHistoryState
string
Workflow step history state (completed, failed, In-progress)

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

docusign-workflowmanagement-api-openapi.yml Raw ↑

Other APIs Docusign publishes across the network.

Docusign Web Forms API
Docusign Notary API
Docusign Navigator API
Docusign Workspaces API
Docusign CLM API
Docusign Connected Fields API
Docusign AccountBrands API
Docusign AccountConsumerDisclosures API
Docusign AccountCustomFields API
Docusign AccountPasswordRules API
Docusign AccountPermissionProfiles API
Docusign Accounts API
Where this information came from

This is an independent, third-party profile of Docusign WorkflowManagement 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.