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 (EntityType)
Value: "Contact"

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 (EntityType)
Value: "Contact"
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": "Contact",
  • "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 (EntityType)
Value: "Contact"

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":
    {
    }
}