Warning | ||
---|---|---|
| ||
This page is in development and as such, its contents may be incorrect |
The workflow API provides functionality that allows a administrator to perform actions such as adding and configuring workflow
Easy Heading Free | ||||||
---|---|---|---|---|---|---|
| ||||||
Section | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get all workflowsLists all the workflows configured in the Aspire, this endpoint need the at least the OPERATOR role to be executed.
Pagination query string parameters Sorting query string parameters Query String Parameters
Response
Response
| |||||||||||||||||||||||||||||
Response code | Description | 200 | Success
Section | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Getall workflows, filtereda single workflowGet information about a single workflow in Aspire, this endpoint need the at least the OPERATOR role to be executed.Lists workflows configured in the Aspire, filtered by a specified criteria
Pagination query string parameters Common filter
Path Parameters
Query String Parameters
Get a single workflowGet information about a single workflow in Aspire
Path Parameters | ||||||||||||||||||||||||||||||||
Name | Type | Required | Description | |||||||||||||||||||||||||||||
id | string | Required | The id of the workflow to return |
string | Optional | The section required for the output. The value can be "templates", "rules", "events" |
Response
Code Block | ||
---|---|---|
| ||
{
"workflow": {
"id": " | ||
Code Block | ||
| ||
{
"workflow": {
"id": "AAABcID5GBc=",
"description": "Publish to Elasticsearch",
...
}
} |
: 200, 404
Section | |||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Add single workflowAdds a single workflow to Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Body Parameters
Query String Parameters
Example
Response
| |||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||
201 | Created | 406 | Not acceptable - there was an issue validating the input
Section | |||||||
---|---|---|---|---|---|---|---|
Delete multiple Update workflows, filteredDelete multiple workflows from Update connectors configured in the Aspire, filtered by a specified criteria, this endpoint need the at least the ADMINISTRATOR role to be executed.
Body Parameters | |||||||
Name | Type | Required | Description | ||||
filter | JSON | Required | Filters workflows to be deleted. Check the filter definition here |
Code Block | ||
---|---|---|
| ||
{ "message": "optionalupdate result response message" } |
See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors
Status
Status: 200, 406
Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete multiple workflows, filteredDelete multiple workflows from Aspire, filtered by a specified criteria, this endpoint need the at least the ADMINISTRATOR role to be executed | |||||||||||||
Section | |||||||||||||
Delete single workflowDelete a single workflow from Aspire.
Path Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete workflow(s)Delete one or more workflows from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
| ||||||||||||||||||||||||||||||||||||||||||||
Name | Type | Required | Description | |||||||||||||||||||||||||||||||||||||||||
id | string | Required | The identifier(s) of the workflow(s) to delete |
Code Block | ||
---|---|---|
| ||
DELETE
|
Response
Code Block | ||
---|---|---|
| ||
{
"message": "optional response message"
} |
Status
|
Path Parameters and Query parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier(s) of the workflow(s) to delete |
Body Parameter
Name | Type | Required | Description |
---|---|---|---|
ids |
Get a event from a workflow in Aspire.
Panel | ||||
---|---|---|---|---|
| ||||
|
Path Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier(s) of the workflow(s) to return |
eventId | string | Required | The identifier of the event to get |
Response
delete |
Examples
Code Block | ||
---|---|---|
| ||
{ "workflow": DELETE /aspire/_api/workflows/AAABcID5GBc DELETE /aspire/_api/workflows?id=AAABcID5GBc&id=AAABcID5GBd POST /aspire/_api/workflows/delete { "idids": ["AAABcIueWUc=AAABcID5GBc","AAABcID5GBd"] } |
Response
Code Block | ||
---|---|---|
| ||
{ "descriptionmessage": "Publishdelete toresult Elasticsearch" "event": { "id": "onUpdate" .... } } } |
Status
response message"
} |
Status: 200, 404, 406
Section | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get a workflow eventGet a event from a workflow in Aspire, this endpoint need the at least the OPERATOR role to be executed | |||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||
Create workflow event(s)Create one or more workflow events in Aspire.
Path Parameters
Examples Create a single event Create multiple events (body parameter) Response
Create multiple events (alternative version) Response
| |||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||
404 | Not found - a given workflow identifier was not found | ||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||
: 200, 404, 406 |
Section | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get workflow eventsGet a event from a workflow in Aspire, this endpoint need the at least the OPERATOR role to be executed Delete a workflow eventDelete a workflow event from Aspire.
Path Path Parameters
Response
Status | |||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||
404 | Not found - a given workflow identifier was not found | ||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||
Section | |||||||||||||||||||||||||
Create a workflow event itemCreate a workflow event item - a rule, condition and the like.
Path Parameters | |||||||||||||||||||||||||
Name | Type | Required | Description | ||||||||||||||||||||||
id | string | Required | The identifier of the workflow(s) to return | ||||||||||||||||||||||
eventId | string | Required | The identifier of the event to get | ||||||||||||||||||||||
type | string | Required | The type of the item to create | ||||||||||||||||||||||
Item Type | Parameter Name | Parameter Type | Required | Description | |||||||||||||||||||||
Reference | parentId | string | Optional | The identifier of the node in to which the item should be inserted. Defaults to the root node | orderId | integer | Required | The position (which in the children of the parent node) where this reference should be inserted | ruleId | String | Required | The rule to be referenced | enabled | boolean | Optional | Whether or not the item is enabled (default true) | |||||||||
Condition | parentId | string | Optional | The identifier of the node in to which the item should be inserted. Defaults to the root node | value | object | Required | The value to be compared against | enabled | boolean | Optional | Whether or not the item is enabled (default true) | |||||||||||||
Exit | parentId | string | Optional | The identifier of the node in to which the item should be inserted. Defaults to the root node | orderId | integer | Required | The position (which in the children of the parent node) where this reference should be inserted | enabled | boolean | Optional | Whether or not the item is enabled (default true) |
Code Block | ||
---|---|---|
| ||
{ "workflow": { "id": "72022651-c2f4-45a9-9e18-2b0ace529cda", "type": "connector", "description": "Test Workflow", "checksum": "2b8dc08a2da838304528b4695109e2379da9a670c5a195dcd27355e8daa20a8b", "events": { "event": [ { "id": "onScan" }, { "id": "onAddUpdate" }, { "id": "onDelete" }, { "id": "AAABcIueWUc=onPublish", "description": "Publish to Elasticsearch" "eventitem": { "id": "onAddUpdate404fefb7-b7f4-48cf-a7b1-81872587a85b", "rule": { "idtype": "AAABcQwxWUc=reference", ... } } } } |
Status
Delete one or more services from Aspire.
Panel | ||||
---|---|---|---|---|
| ||||
|
Path Parameters
The identifier of the event to use
Body Parameters
The request body parameters will differ depending on the type of item created. See Create a workflow event item above
Response
Code Block | ||
---|---|---|
| ||
{ "workflow": { "id": "AAABcIueWUc=", "description": "Publish to Elasticsearch" "event": { "id": "onAddUpdate", "ruleId": "5d1273b8-9dc0-4f6d-89f3-fe6f331a6067", "enabled": true } }, { "id": "onError" "rule": { "id": "AAABcQwxWUc=" }, ... }{ } } } |
Status
"id": "onIdentity"
},
{
"id": "onIdentityError"
}
]
}
}
} |
Status: 200, 404, 406
Section | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Create workflow event(s)Create one or more workflow events in Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed. Delete single workflow event item
Path Parameters
Response Examples Create multiple events (body parameter)
StatusResponse Response
| ||||||||||||||||||||||||||||||||||||
200 | Success | |||||||||||||||||||||||||||||||||||
404 | Not found - a given workflow identifier was not found | |||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input |
| |
{
"workflow": {
"id": "AAABcIueWUc=",
"description": "Publish to Elasticsearch"
"event": {
"id": ["scan", "addUpdate"]
}
}
} |
Status: 200, 404, 406
Section | |||||||
---|---|---|---|---|---|---|---|
Delete a workflow eventDelete a workflow event from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Path | |||||||
Section | |||||||
Move a workflow event itemDelete one or more services from Aspire.
Path Parameters | |||||||
Name | Type | Required | Description | ||||
id | string | Required | The identifier of the workflow to use | ||||
eventId | string | Required | The identifier of the event to use |
Name | Type | Required | Description |
---|---|---|---|
srcid | string | Required | The identifier of the event item to moveworkflow(s) to use |
eventIddest | string | Required | The identifier of the new parent for the moved itemevent to delete |
Response
Code Block | ||
---|---|---|
| ||
{ "message": "optionaldelete result response message" } |
: 200, 404, 406
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Create a workflow event itemCreate a workflow event item - a rule, condition and the like, this endpoint need the at least the ADMINISTRATOR role to be executed Get workflow templatesRetrieve all workflow templates from Aspire.
Path Parameters
Query String Parameters
Response
Status | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given workflow identifier was not found | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Body Parameters The request body parameters will differ depending on the type of item created. Some examples are shown below
Get single workflow templateRetrieve a single workflow templates from Aspire.
Path Parameters
Response
Status | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given workflow identifier was not found | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get single workflow ruleGet a single workflow rule from Aspire.
Path Parameters
Response
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given workflow identifier was not found | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
: 200, 404, 406 |
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Update a workflow event itemUpdate a workflow event item from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Create a workflow ruleCreate a single workflow rule in Aspire.
Path Parameters
Body Parameters The request body parameters will differ depending on the type of rule item created. Some examples are shown below
Optionally you may opt to add the created rule to a workflow event by adding the following query parameters
Response when parentId used
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete single workflow event itemDelete a workflow event item from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Path Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Move a workflow event itemMove a workflow event item from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Path Parameters
Body Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get workflow templatesRetrieve all workflow templates from Aspire, this endpoint need the at least the OPERATOR role to be executed.
Path Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get single workflow templateRetrieve a single workflow templates from Aspire, this endpoint need the at least the OPERATOR role to be executed.
Path Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get single workflow ruleGet a single workflow rule from Aspire, this endpoint need the at least the OPERATOR role to be executed.
Path Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get workflow rulesGet workflow rules from Aspire, this endpoint need the at least the OPERATOR role to be executed.
Path Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Create a workflow ruleCreate a single workflow rule in Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Path Parameters
Body Parameters The request body parameters will differ depending on the type of rule created.
Optionally you may opt to add the created rule to a workflow event by adding the following query parameters
Response when parentId used
Response without parentId
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Update single workflow ruleUpdatee a single workflow rule in Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Path Parameters
Body Parameters The request body parameters will differ depending on the type of rule created. See Create a workflow rule above Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete single workflow ruleDeletes a single workflow rule from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Path Parameters
Response
Status: 200, 404, 406 |
Section | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete workflow rulesDeletes a single workflow rule from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Path Parameters
Query Parameters
Response
Status: 200, 404, 406 |
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Export workflow(s)Export one or more workflows from Aspire, this endpoint needs at least the OPERATOR role to be executed.
Path Parameters and Query parameters
Body Parameter
Examples
Response
Response without parentId
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given workflow identifier was not found | ||||||||||||||||||||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||
: 200, 404, 406
Update single workflow ruleUpdatee a single workflow rule in Aspire
Path Parameters | |||||||||||||||||||||||||||||||||||||||||||||||||||||
Name | Type | Required | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||
id | string | Required | The identifier of the workflow to update a rule for | ||||||||||||||||||||||||||||||||||||||||||||||||||
ruleId | string | Required | The identifier of the rule to update |
Filters: The connection filter definition here Response
|
Status
Deletes a single workflow rule from Aspire.
Panel | ||||
---|---|---|---|---|
| ||||
|
Path Parameters
The identifier of the workflow from which to delete rule(s) or the identifier of the rule to delete when used in the body
Response
Code Block | ||
---|---|---|
| ||
{
"message": "optional response message"
} |
Status
Lists all available workflow item types
Panel | ||||
---|---|---|---|---|
| ||||
GET /aspire/_api/workflows/itemType |
Response
Code Block | ||
---|---|---|
| ||
{
type: [ "application", "publisher", "function"]
} |
Status
Returns a workflow item by its type
Panel | ||||
---|---|---|---|---|
| ||||
GET /aspire/_api/workflows/itemType/:id |
Path Parameters
The identifier of the workflow item type
Example
Code Block | ||
---|---|---|
| ||
/aspire/_aspire/workflows/types/applications |
Response
Code Block | |||||||
---|---|---|---|---|---|---|---|
| |||||||
{
items: [{
"id": "AAABcID5GBc="
"type": "application",
|
Status
Status: 200 |
Section |
---|
ImportThe import usage can be found here |
Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Filters
Some endpoint queries require a filter. A filter is basically a JSON object with the following format: Seed filter:
| |||||||||||||
Section | |||||||||||||
Get workflow item type dxf (TODO: to be moved)Returns the dxf for a specific workflow item type
Response
Status | |||||||||||||
Response code | Description | ||||||||||||
200 | Success | 404 | Not found - a given service identifier was not found