Update a Workflow state to ENDED triggering any processes related to this specific state.

POST http://api.kompliant.com/workflow.complete (OpenAPI specification)

Usage Info

Complete a workflow by updating its state to ENDED, triggering final processing tasks based on the workflow type.

This method is only supported for Workflows of type BUSINESS_APPLICATION.

The triggered tasks depends on the account configuration.

Request

Parameter	Type	Required	Description
workflow_id	string	Yes	The identifier for the Workflow.

{
  "workflow_id": "w_7h1EpxerrZQyLnRC1EQ9Ck",
}

An empty data object is returned when the completion is successful.

{
  "meta": {
    "status": "SUCCESS",
    "trace_id": "trc_6zNzQZHSf26V83BO3uW6dS",
    "version": "2025-03-24"
  },
  "data": {}
}

Error Code	HTTP Code	Possible Cause
BAD_REQUEST	400	Required parameters not provided.
ENTITY_NOT_FOUND	400	The `workflow_id` provided does not exist.
MISSING_REQUIREMENTS	400	The Workflow has missing requirements. For more details on the content of this error response refer to workflow.canComplete's Missing Requirements Parameters.
SYSTEM_RULE_VIOLATION	400	System rule violations are described below.

When a SYSTEM_RULE_VIOLATION error occurs, the response will include additional entity_type and sub_code fields to provide more specific information:

Entity Type	Sub-code	Description
Workflow	INVALID_WORKFLOW_TYPE	The method is not supported for the current Workflow type.
Workflow	WORKFLOW_ENDED	The Workflow is in an ENDED state and cannot completed.