Loading

DFS Workflow Services API (latest)

Download OpenAPI specification:Download

Contains functionality around Workflows.

For endpoints that support localization the language can be passed either as a query string parameter (using the name 'language') or in the 'accept-language' header.
If no language is passed to such endpoints then the default configured language will be used.

Workflows

Get workflow status

Gets the status of a workflow.

Authorizations:
path Parameters
workflowName
required
string

The name of the workflow.

workflowInstanceId
required
string <uuid>

The workflow instance ID to get the status for.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

get/v1.0/workflows/{workflowName}/{workflowInstanceId}/status
https://example-host/v1.0/workflows/{workflowName}/{workflowInstanceId}/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "data": null
}

Get workflow payload JSON schema

Gets the payload JSON schema of a workflow.

Authorizations:
path Parameters
workflowName
required
string

The name of the workflow.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

get/v1.0/workflows/{workflowName}/schema
https://example-host/v1.0/workflows/{workflowName}/schema

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Get WorkflowEntityHistory

Get WorkflowEntityHistory for a given entity.

Authorizations:
path Parameters
entityType
required
string

Type of the Entity.

entityId
required
string

Id of the Entity.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

get/v1.0/workflows/entities/{entityType}/{entityId}/history
https://example-host/v1.0/workflows/entities/{entityType}/{entityId}/history

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "workflowEntityHistory":
    [
    ]
}

Update a workflow

Updates a workflow.

Authorizations:
path Parameters
workflowName
required
string

The name of the workflow.

workflowInstanceId
required
string <uuid>

The workflow instance ID to update.

milestoneName
required
string

The name of the milestone.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request payload.

payload
required
any

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

patch/v1.0/workflows/{workflowName}/{workflowInstanceId}/{milestoneName}/update
https://example-host/v1.0/workflows/{workflowName}/{workflowInstanceId}/{milestoneName}/update

Request samples

Content type
Copy
Expand all Collapse all
{
  • "payload": null
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "data": null
}

Start a workflow

Starts a workflow.

Authorizations:
path Parameters
workflowName
required
string

The name of the workflow.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request payload.

payload
required
any

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

post/v1.0/workflows/{workflowName}/start
https://example-host/v1.0/workflows/{workflowName}/start

Request samples

Content type
Copy
Expand all Collapse all
{
  • "payload": null
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "workflowInstanceId": "string",
  • "data": null
}

Query workflow related data

Queries data that is related to a workflow.

Authorizations:
path Parameters
workflowName
required
string

The name of the workflow.

queryName
required
string

The name of the query.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request payload.

payload
any Nullable
workflowInstanceId
string <uuid> Nullable

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

post/v1.0/workflows/{workflowName}/{queryName}/query
https://example-host/v1.0/workflows/{workflowName}/{queryName}/query

Request samples

Content type
Copy
Expand all Collapse all
{
  • "payload": null,
  • "workflowInstanceId": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "data": null
}

Create WorkflowEntity

Create WorkflowEntity for a given entity.

Authorizations:
path Parameters
workflowInstanceId
required
string <uuid>

The workflowInstanceId of the workflow.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request payload.

entityType
string Nullable
entityId
string Nullable
workflowName
string Nullable

Responses

201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

post/v1.0/workflows/entities/{workflowInstanceId}
https://example-host/v1.0/workflows/entities/{workflowInstanceId}

Request samples

Content type
Copy
Expand all Collapse all
{
  • "entityType": "string",
  • "entityId": "string",
  • "workflowName": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "code": "General",
  • "subCode": "string",
  • "message": "string",
  • "correlationId": "string",
  • "properties":
    {
    }
}

Complete Workflow

Complete a Workflow for a given entity.

Authorizations:
path Parameters
workflowName
required
string

Name of the workflow

workflowInstanceId
required
string <uuid>

The workflowInstanceId of the workflow.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request payload.

status
string (WorkflowStatus)
Enum: "Completed" "Abandoned" "Rejected" "Failed"
data
any Nullable

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

post/v1.0/workflows/{workflowName}/{workflowInstanceId}/complete
https://example-host/v1.0/workflows/{workflowName}/{workflowInstanceId}/complete

Request samples

Content type
Copy
Expand all Collapse all
{
  • "status": "Completed",
  • "data": null
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "code": "General",
  • "subCode": "string",
  • "message": "string",
  • "correlationId": "string",
  • "properties":
    {
    }
}

Get active WorkflowEntities

Get active WorkflowEntities

Authorizations:
path Parameters
entityType
required
string

Type of the Entity

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

List of EntityIds

entityIds
Array of strings Nullable

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

post/v1.0/workflows/entities/{entityType}/active
https://example-host/v1.0/workflows/entities/{entityType}/active

Request samples

Content type
Copy
Expand all Collapse all
{
  • "entityIds":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "activeWorkflowEntities":
    [
    ]
}

Cancel Workflow

Cancel a Workflow for a given workflowname and workflowInstanceId

Authorizations:
path Parameters
workflowName
required
string

Name of the workflow

workflowInstanceId
required
string <uuid>

The workflowInstanceId of the workflow

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request payload

cancellationReason
string Nullable

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

post/v1.0/workflows/{workflowName}/{workflowInstanceId}/cancel
https://example-host/v1.0/workflows/{workflowName}/{workflowInstanceId}/cancel

Request samples

Content type
Copy
Expand all Collapse all
{
  • "cancellationReason": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "code": "General",
  • "subCode": "string",
  • "message": "string",
  • "correlationId": "string",
  • "properties":
    {
    }
}