Query: Find Maestro Workflow Instance

Docusign Operation

The Find Maestro Workflow Instance query retrieves the status and details of a specific running or completed instance of a Maestro workflow.

Example User Story

I want to find the current status of a purchase order approval workflow instance in DocuSign Maestro, so I can follow up with the finance team if it’s delayed.

Fields

Field Name	Field Type	Required
workflowID	String	Yes
instanceID	String	No

Related Connections

Docusign

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "find-maestro-workflow-instance",
  "state": "inDev",
  "meta": {
    "short": "Find Maestro Workflow Instance",
    "description": "Finds a Maestro workflow instance by ID or other criteria."
  },
  "input": [
    {
      "name": "workflowID",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the workflow to find."
      }
    },
    {
      "name": "instanceID",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The ID of the workflow instance to find."
      }
    }
  ],
  "output": [
    {
      "name": "instance",
      "type": "Object",
      "selector": ["instance"],
      "meta": {
        "description": "The found workflow instance."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "GET",
        "path": "/workflows/{{workflowID}}/instances/{{instanceID}}",
        "headers": {}
      }
    }
  ]
}