POST Workflow Instances Instance ID Signals

The POST /WorkflowClosed A workflow is a series of steps necessary to complete a process. In Keyfactor Command, it refers to the workflow builder, which allows you to automate event-driven tasks such as when a certificate is requested, revoked or found in a certificate store./Instances/{instanceId}/Signals operation inputs signals to the workflow instance with the specified GUID. On success, the operation returns 204 with no content.

Note:  If a workflow instance is initiated for a workflow definition that has more than one step requiring input (signals), a user can only provide that input (for example, approve or deny a require approval request) at the step in the workflow instance where the workflow instance was suspended pending input. The user cannot jump ahead and provide input for future steps in the workflow that have not yet occurred.
Note:  A locking conflict may occur if two (or more) users attempt to provide input to a workflow instance (for example, approve a request) at exactly the same time. If this happens, input from only one of the users will be reflected in the Management Portal, and the workflow instance will not be moved along to the next step if it should have been with input from the two users. The other input is still accepted, however, and there is a scheduled task that runs daily and attempts to continue all suspended workflows that may be eligible to continue but have not done so due to locking conflicts.
Tip:  The following permissions (see Security Roles and Claims) are required to use this feature:

The user executing the request must hold at least one security role ID configured in the workflow definition step for which signal data is being input.

Table 1186: POST Workflow Instances {instanceid} Signals Input Parameters

Name In Description
instanceId Path

Required. A string indicating the Keyfactor Command reference GUID of the workflow instance to which to input a signal.

Use the GET Workflow Instances operation to retrieve a list of all the workflow instances to determine the GUID.

SignalKey Body

Required. A string indicating the key for the signal. This is made up of the unique name for the step within the definition plus the signal type, separated by a period (UniqueName.SignalType). For a Require Approval step, the key input type will be ApprovalStatus, so the full SignalKey will look something like:

RequireApproval1.ApprovalStatus

Use the GET Workflow Definitions Definition ID operation to return workflow details including the workflow steps to determine the UniqueName of the step for which you want to input a signal or one of the GET operations for workflow instances (see GET Workflow Instances, GET Workflow Instances AssignedToMe, or GET Workflow Instances My) to return the CurrentStepUniqueName.
Data Body

Required. An object providing the input information for the signal. The keys will vary depending on the signal. ClosedShow RequireApproval signal data details.

For example, to approve a Require Approval step called RequireApproval1 with a comment:

Copy 
{
   "SignalKey": "RequireApproval1.ApprovalStatus",
   "Data": {
      "Approved": "True",
      "Comment": "Here is my comment."
   }
}
Tip:  See the Keyfactor APIClosed An API is a set of functions to allow creation of applications. Keyfactor offers the Keyfactor API, which allows third-party software to integrate with the advanced certificate enrollment and management features of Keyfactor Command. Reference and Utility, which allows you to call API operations and view results. It is primarily intended for validation, testing, and workflow development, and also serves as an interactive supplement to this API documentation. You can access it from the help menu () in the Management Portal.