Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning
titlePage in development

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

Table of Contents

Response

Section
List

Get all workflows

Lists all the workflows configured in the Aspire

Panel
borderColorblack
bgColor#fafafb
GET /aspire/_api/workflow


Query String Parameters

Name
from
Type
integer
RequiredDescription
descriptionstringOptionalFilter workflows to only those whose description matches the given expression
sparsebooleanOptionalOnly return minimal data such as identifier, description, name etc
OptionalIndicates the initial page to be retrieved
sizeintegerOptionalSpecifies the size of results page
sortBystringOptionalField by which results are sorted
sortModestringOptional

Sort mode

  • "asc" for ascending sort,
  • "desc" for descending sort
expandstringOptionalList of fields to expand, * will expand everything
sparsebooleanOptionalOnly return minimal data such as identifier, description, name etc


Response

Code Block
languagejs
{
  "
Code Block
languagejs
{
  "workflow": [{
    "id": "AAABcID5GBc=",
    "description": "Publish to Elasticsearch",
    ...
  },
  {
    "id": "AAABcIueWUc=",
    "description": "Normalise data",
    ...
  }]
}

Status

Response codeDescription
200Success




Section

Get

a single workflow

all workflows, filtered

Lists workflows configured in the Aspire, filtered by a specified criteriaGet information about a single workflow in Aspire

Panel
borderColorblack
bgColor#fafafb

GET POST /aspire/_api/workflowworkflows/:idgetAll


Path Query String Parameters

idstring
NameTypeRequiredDescription
fromintegerRequiredOptionalThe id of the workflow to return

Response

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcID5GBc=",
    "description": "Publish to Elasticsearch",
    ...
  }
}

Status

Response codeDescription
200Success
404The given workflow id was not found
Section
Indicates the initial page to be retrieved
sizeintegerOptionalSpecifies the size of results page
sortBystringOptionalField by which results are sorted
sortModestringOptional

Sort mode

  • "asc" for ascending sort,
  • "desc" for descending sort
expandstringOptionalList of fields to expand, * will expand everything
sparsebooleanOptionalOnly return minimal data such as identifier, description, name etc


Add a workflow

Adds a workflow to Aspire

Panel
borderColorblack
bgColor#fafafb
POST /aspire/_api/workflow

Request Body Parameters

NameTypeRequiredDescription
descriptionfilterstringJSONRequiredA description of the workflow

Query String Parameters

NameTypeRequiredDescription
typestringRequired

Accepted values are: "connector" and "service"

If connector is set the workflow created with the following events will be created:

  • onScan
  • onAddUpdate
  • onDelete
  • onPublish
  • onError

If service is set the workflow will be created without events.

Filters retrieved connectors. Check the filter definition here


Response

Code Block
languagejs
{
  "workflow": [{
    "id": "AAABcID5GBc=",
    

Examples

Add a single workflow: /aspire/_api/workflow?type=connector

Code Block
languagejs
{
  "description": "Publish to ElasticElasticsearch"
}

Response

Code Block
languagejs
{
  "workflow":,
    ...
  },
  {
    "id": "AAABcID5GBcAAABcIueWUc=",
    "description": "PublishNormalise to Elasticdata",
    "type": "connector"
    ....
  }]
}


Status

Response codeDescription
201200Created
406Not acceptable - there was an issue validating the input
Success




Section

Get a single workflow

Get information about a single workflow in Aspire

Section

Delete workflow(s)

Delete one or more workflow from Aspire.

Panel
borderColorblack
bgColor#fafafb

DELETE GET /aspire/_api/workflow/:idDELETE /aspire/_api/workflow


Path and Query String Parameters

identifier(s) (s) delete
NameTypeRequiredDescription
idstringRequiredThe id of the workflow to return


ExamplesResponse

Delete a single workflow

Code Block
languagejs
DELETE /aspire/_api/workflows/AAABcID5GBc=

Delete multiple workflows

Code Block
languagejs
DELETE /aspire/_api/workflows?id=AAABcID5GBc=&id=AAABcIueWUc=

Response

Code Block
languagejs
{
	"message": "optional response message"
{
  "workflow": {
    "id": "AAABcID5GBc=",
    "description": "Publish to Elasticsearch",
    ...
  }
}

Status

Response codeDescription
200Success
404Not found - a The given workflow identifier id was not found
406Not acceptable - there was an issue validating the input
Section




Section

Add single workflow

Adds a single workflow to Aspire

Get a workflow event

Get a event from a workflow in Aspire.

Panel
borderColorblack
bgColor#fafafb
GET POST /aspire/_api/workflow/:id/:eventId


Body Path Parameters

string
NameTypeRequiredDescription
iddescriptionstringRequiredThe identifier A description of the workflow(s) to returneventId


Query String Parameters

NameTypeRequiredThe identifier of the event to get

Response

Description
typestringRequired

Accepted values are: "connector" and "service"

If connector is set the workflow created with the following events will be created:

  • onScan
  • onAddUpdate
  • onDelete
  • onPublish
  • onError

If service is set the workflow will be created without events.


Example

Code Block
languagejs
/aspire/_api/workflow?type=connector
Code Block
languagejs
{
  "workflowdescription": "Publish to Elastic"
}


Response

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUcAAABcID5GBc=",
    "description": "Publish to ElasticsearchElastic",
    "eventtype": {
      "id": "onUpdate""connector"
       ....
    }
  }
}


Status

Response codeDescription
200201SuccessCreated
404406Not found - a given workflow identifier was not found406Not acceptable - there was acceptable - there was an issue validating the input




Section

Delete multiple workflows, filtered

Delete multiple workflows from Aspire, filtered by a specified criteria

Create workflow event(s)

Create one or more workflow events in Aspire.

Panel
borderColorblack
bgColor#fafafb

PUT POST /aspire/_api/workflowworkflows/:id

PUT /aspire/_api/workflow/:id/:eventId

deleteAll


Body Path Parameters

NameTypeRequiredDescription
idfilterstringJSONRequiredThe identifier of the workflow(s) to add a event to
eventIdstringRequiredThe identifier of the event to add

Examples

Create a single event

Create multiple events (body parameter)

Filters workflows to be deleted. Check the filter definition here


Response

Code Block
languagejs
[{
  "idmessage": "scan"
},
{
  "id": "addUpdate"
}]

Create multiple events (alternative version)

Response

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": ["scan", "addUpdate"]
    }
  }
}
optional response message"
}

See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors

Status

Response codeDescription
200Success
404Not found - a given credential identifier was not found
406Not acceptable - there was an issue validating the input




Section

Delete single workflow

Delete a single workflow from Aspire.

Panel
borderColorblack
bgColor#fafafb

DELETE /aspire/_api/workflow/:id


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the workflow(s) to delete


Example

Code Block
languagejs
DELETE /aspire/_api/workflows/AAABcID5GBc=


Response

Code Block
languagejs
{
	"message": "optional response message"
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section
Delete

Get a workflow event

Delete Get a workflow event from a workflow in Aspire.

Panel
borderColorblack
bgColor#fafafb

DELETE GET /aspire/_api/workflow/:id/:eventId


Path and Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow(s) to usereturn
eventIdstringRequiredThe identifier of the event to deleteget


Response

Code Block
languagejs
{
  "workflow": {
    "messageid": "optional response message"
}

Status

AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": "onUpdate"
       ....
    }
  }
}


Status

Response codeResponse codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section

Create

a

workflow event

item

(s)

Create a workflow event item - a rule, condition and the likeone or more workflow events in Aspire.

Panel
borderColorblack
bgColor#fafafb

POST PUT /aspire/_api/workflow/:id

PUT /:eventIdaspire/_api/workflow/:id/:typeeventId


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow(s) to returnadd a event to
eventIdstringRequiredThe identifier of the event to get
typestringRequiredThe type of the item to create

Request Body Parameters

The request body parameters will differ depending on the type of item created. Some examples are shown below

add


Examples

Create a single event

Create multiple events (body parameter)

Code Block
languagejs
[{
  "id": "scan"
},
{
  "id": "addUpdate"
}]

Create multiple events (alternative version)


Response

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": ["scan", "addUpdate"]
    }
  }
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Response

Section

Delete a workflow event

Delete a workflow event from Aspire.

Panel
borderColorblack
bgColor#fafafb

DELETE /aspire/_api/workflow/:id/:eventId


Path  Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow(s) to use
eventIdstringRequiredThe identifier of the event to delete


Response

Item TypeParameter NameParameter TypeRequiredDescription
ReferenceparentIdstringOptionalThe identifier of the node in to which the item should be inserted. Defaults to the root node
orderIdintegerRequiredThe position (which in the children of the parent node) where this reference should be insertedruleIdStringRequiredThe rule to be referencedenabledbooleanOptionalWhether or not the item is enabled (default true)
ConditionparentIdstringOptionalThe identifier of the node in to which the item should be inserted. Defaults to the root node
valueobjectRequiredThe value to be compared againstenabledbooleanOptionalWhether or not the item is enabled (default true)
ExitparentIdstringOptionalThe identifier of the node in to which the item should be inserted. Defaults to the root node
orderIdintegerRequiredThe position (which in the children of the parent node) where this reference should be insertedenabledbooleanOptionalWhether or not the item is enabled (default true)
Code Block
languagejs
{
  "workflowmessage": {
"optional response   "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": "onAddUpdate",
      "rule": {
        "id": "AAABcQwxWUc=",
        ...
      }
    }
  }
}

Status

Response codeDescription200Success404Not found - a given workflow identifier was not found406Not acceptable - there was an issue validating the input
message"
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Response

Section

Create a workflow event item

Create a workflow event item - a rule, condition and the like.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/workflow/:id/:eventId/:type


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow(s) to return
eventIdstringRequiredThe identifier of the event to get
typestringRequiredThe type of the item to create


Body Parameters

The request body parameters will differ depending on the type of item created. Some examples are shown below

Item TypeParameter NameParameter TypeRequiredDescription
ReferenceparentIdstringOptionalThe identifier of the node in to which the item should be inserted. Defaults to the root node
Section

Update a workflow event item

Delete one or more services from Aspire.

Panel
borderColorblack
bgColor#fafafb

PUT /aspire/_api/workflow/:id/:eventId/:orderId

Path Parameters

The identifier of the event to use
NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow(s) to use
eventIdstringRequired

orderIdintegerRequiredThe order identifier of the item to update

Request 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
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": "onAddUpdate",
      "rule": {
        "id": "AAABcQwxWUc=",
        ...
      }
    }
  }
}

Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input
Section
position (which in the children of the parent node) where this reference should be inserted

ruleIdStringRequiredThe rule to be referenced

enabledbooleanOptionalWhether or not the item is enabled (default true)
ConditionparentIdstringOptionalThe identifier of the node in to which the item should be inserted. Defaults to the root node

valueobjectRequiredThe value to be compared against

enabledbooleanOptionalWhether or not the item is enabled (default true)
ExitparentIdstringOptionalThe identifier of the node in to which the item should be inserted. Defaults to the root node

orderIdintegerRequiredThe position (which in the children of the parent node) where this reference should be inserted

enabledbooleanOptionalWhether or not the item is enabled (default true)


Response

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": "onAddUpdate",
      "rule": {
        "id": "AAABcQwxWUc=",
        ...
      }
    }
  }
}


Delete a workflow event item

Panel
borderColorblack
bgColor#fafafb

DELETE /aspire/_api/workflow/:id/:eventId/:parentId/:orderId

Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to use
eventIdstringRequiredThe identifier of the event to use
parentIdstringRequiredThe identifier of the node with the item to be deleted
orderIdintegerRequiredThe order identifier of the item to delete
Code Block
languagejs
{
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section
Move

Update a workflow event item

Delete one or more services from Aspire.

Panel
borderColorblack
bgColor#fafafb

PUT /aspire/_api/workflow/:id/move:eventId/:eventIdorderId


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow(s) to use
eventIdstringRequired

The identifier of the event to use

Body Parameters

Type
orderIdintegerNameRequiredDescriptionsrcstringRequiredThe The order identifier of the event item to move
deststringRequiredThe identifier of the new parent for the moved item

Response

update


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
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": "onAddUpdate",
      "rule": {
        "id": "AAABcQwxWUc=",
        ...
      }
    }
  }
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section

Delete single workflow event item


Panel
borderColorblack
bgColor#fafafb

DELETE /aspire/_api/workflow/:id/:eventId/:parentId/:orderId


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to use
eventIdstringRequiredThe identifier of the event to use
parentIdstringRequiredThe identifier of the node with the item to be deleted
orderIdintegerRequiredThe order identifier of the item to delete


Response

Code Block
languagejs
{
  "message": "optional response message"
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section

Move a workflow event item

Delete one or more services from Aspire.

Panel
borderColorblack
bgColor#fafafb

PUT/aspire/_api/workflow/:id/move/:eventId


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to use
eventIdstringRequiredThe identifier of the event to use


Body Parameters

NameTypeRequiredDescription
srcstringRequiredThe identifier of the event item to move
deststringRequiredThe identifier of the new parent for the moved item


Response

Code Block
languagejs
{
  "message": "optional response message"
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section

Get workflow templates

Retrieve all workflow templates from Aspire.

Panel
borderColorblack
bgColor#fafafb

GET /aspire/_api/workflows/:id/templates


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to get the templates for


Query String Parameters

NameTypeRequiredDescription
fromintegerOptionalIndicates the initial page to be retrieved
sizeintegerOptionalSpecifies the size of results page
sortBystringOptionalField by which results are sorted
sortModestringOptional

Sort mode

  • "asc" for ascending sort,
  • "desc" for descending sort


Response

Code Block
languagejs
{
  "template": [{
      "id": "AAABcQwrWUc",
      ...
    },
	  "id": "AAABcQwrWUd",
      ...
    }]
  "message": "optional response message"
}



Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section

Get all workflow templates, filtered

Lists workflow templates configured in the Aspire, filtered by a specified criteria

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/workflows/:id/templates/getAll


Query String Parameters

NameTypeRequiredDescription
fromintegerOptionalIndicates the initial page to be retrieved
sizeintegerOptionalSpecifies the size of results page
sortBystringOptionalField by which results are sorted
sortModestringOptional

Sort mode

  • "asc" for ascending sort,
  • "desc" for descending sort
expandstringOptionalList of fields to expand, * will expand everything


Body Parameters

NameTypeRequiredDescription
filterJSONRequiredFilters retrieved workflow templates. Check the filter definition here


Response

Code Block
languagejs
{
  "template": [{
      "id": "AAABcQwrWUc",
      ...
    },
	  "id": "AAABcQwrWUd",
      ...
    }]
  "message": "optional response message"
}



Status

Response codeDescription
200Success




Section

Get single workflow template

Retrieve a single workflow templates from Aspire.

Panel
borderColorblack
bgColor#fafafb

GET /aspire/_api/workflow/:id/template/:templateId


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to get the templates for
templateIdstringRequiredThe identifier of the template to get


Response

Code Block
languagejs
{
  "template": [{
      "id": "AAABcQwrWUc",
      ...
    }]
  "message": "optional response message"
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input



Section

Get single workflow rule

Get a single workflow rule from Aspire.

Panel
borderColorblack
bgColor#fafafb

GET /aspire/_api/workflow/:id/rule/:ruleId


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to return rules for
ruleIdstringRequiredThe identifier of the rule to get


Response

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "rule": {
      "id": "ddSWeq123",
      "description": "Some rule",
      "type": "application",
      ...
    }
  }
Code Block
languagejs
{
  "message": "optional response message"
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input
Section
an issue validating the input




Response

Section

Create a workflow rule

Create a single workflow rule in Aspire.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/workflow/:id/rules


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to create a rule for


Body Parameters

The request body parameters will differ depending on the type of rule created. Some examples are shown below

Rule TypeParameter NameParameter TypeRequiredDescription
groovy<TODO>


application




Optionally you may opt to add the created rule to a workflow event by adding the following query parameters


Parameter NameParameter

Get workflow templates

Retrieve all workflow templates from Aspire.

Panel
borderColorblack
bgColor#fafafb

GET /aspire/_api/workflows/:id/templates

Path and Query String Parameters

id
Name TypeRequiredDescription
parentIdstringRequiredThe identifier of the workflow to get the templates for
descriptionstringOptionalFilter workflows to only those whose description matches the given expression

Response

The identifier of the node in to which the item should be inserted. Defaults to the root node
orderIdintegerRequiredThe position (which in the children of the parent node) where this reference should be inserted


Response when parentId used

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": 
Code Block
languagejs
{
  "template": [{
      "id": "AAABcQwrWUconAddUpdate",
       ..."rule": {
    }]    "id": "ddSWeq123",
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input
Section
      "description": "Some rule",
        "type": "application",
        ...
      }
    }
  }
}


Response without parentId

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "rule": 

Get a workflow template

Retrieve a workflow templates from Aspire.

Panel
borderColorblack
bgColor#fafafb

GET /aspire/_api/workflow/:id/template/:templateId

Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to get the templates for
templateIdstringRequiredThe identifier of the template to get
Code Block
languagejs
{
  "template": [{
      "id": "AAABcQwrWUcddSWeq123",
      ..."description": "Some rule",
    }]
  "messagetype": "optional response message"application",
      ...
    }
  }
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section
Get a

Update single workflow rule

Get one or more Updatee a single workflow rule from in Aspire.

Panel
borderColorblack
bgColor#fafafb

GET PUT /aspire/_api/workflow/:id/rule/:ruleIdruleId


Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to return rules update a rule for
ruleIdruleIdstringRequiredThe identifier of the rule to getupdate

Response


Body Parameters

The request body parameters will differ depending on the type of rule created. See Create a workflow rule above


Response

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=
Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "rule": {
      "id": "ddSWeq123",
      "description": "Some rule",
      "type": "application",
    "description":  ...
    }
  }
}

Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input
"Publish to Elasticsearch"
    "rule": {
      "id": "ddSWeq123",
      "description": "Some rule",
      "type": "application",
      ...
    }
  }
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Section

Delete single workflow rule

Deletes a single workflow rule from Aspire.

Panel
borderColorblack
bgColor#fafafb

DELETE /aspire/_api/workflows/:id/rule/:ruleId


Path Parameters

NameTypeRequiredDescription
idstringRequired

The identifier of the workflow from which to delete rule(s) or the identifier of the rule to delete when used in the body

ruleIdstringRequiredThe identifier of the rule to delete


Response

Code Block
languagejs
{
  "message": "optional response message"
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input




Request Body Parameters

The request body parameters will differ depending on the type of rule 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

Section

Get workflow item types

Lists all available workflow item types

Panel
borderColorblack
bgColor#fafafb
GET /aspire/_api/workflows/itemType


Response

Code Block
languagejs
{
  type: [ "application", "publisher", "function"]
}
Section

Create a workflow rule

Delete one or more services from Aspire.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/workflow/:id/rules

Path Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the workflow to create a rule for
Rule TypeParameter NameParameter TypeRequiredDescription
groovy<TODO>application
Parameter NameParameter TypeRequiredDescription
parentIdstringRequiredThe identifier of the node in to which the item should be inserted. Defaults to the root node
orderIdintegerRequiredThe position (which in the children of the parent node) where this reference should be inserted
Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "event": {
      "id": "onAddUpdate",
      "rule": {
        "id": "ddSWeq123",
        "description": "Some rule",
        "type": "application",
        ...
      }
    }
  }
}

Response without parentId

Code Block
languagejs
{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "rule": {
      "id": "ddSWeq123",
      "description": "Some rule",
      "type": "application",
      ...
    }
  }
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input
Section




Request Body Parameters

The request body parameters will differ depending on the type of rule created. See Create a workflow rule above
Section

Get specific workflow items by type

Returns a workflow item by its type

Update a workflow rule

Delete one or more services from Aspire.

Panel
borderColorblack
bgColor#fafafb
PUT GET /aspire/_api/workflowworkflows/itemType/:id/rule/:ruleId


Path Parameters

NameTypeRequiredDescription
idstringRequired

The identifier of the workflow

to update a rule for
ruleIdstringRequiredThe identifier of the rule to update

item type


Example

Code Block
languagejs
/aspire/_aspire/workflows/types/applications 


Response

Code Block
languagejs
{
    items: [{
			  "id": "AAABcID5GBc="
			  "type": "application",
        	  "description": "Application_1",
          	  "workflow": {
coordinates": "com.accenture.aspire:aspire-example-app"
            },
            {
			  "id": 	"AAABcIueWUcAAABcID5GBd=",
	 		  "type": "descriptionapplication":,
 "Publish to Elasticsearch"
    "rule": {
      "iddisplay": "ddSWeq123Application_2",
      "description": "Some rule",
      "typecoordinates": "application",com.accenture.aspire:aspire-example-app"
      ...
    }
  }]
}


Status

Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406Not acceptable - there was an issue validating the input
Section
Description
200Success




Examples

Delete multiple workflows

Section

Get connector type dxf

Returns the dxf for a specific workflow item type

Delete workflow rule(s)

Delete one or more workflows from Aspire.

Panel
borderColorblack
bgColor#fafafb
DELETE GET /aspire/_api/workflows/:id/rule

DELETE /aspire/_api/workflows/:id/rule/:ruleId

Path and Query String Parameters

NameTypeRequiredDescription
idstringRequired

The identifier of the workflow from which to delete rule(s) or the identifier of the rule to delete when used in the body

ruleIdstringRequiredThe identifier of the rule to delete
Code Block
languagejs
DELETE /aspire/_api/workflows/AAABcID5GBc%3D/rule?id=AAABcID5GBc=&id=AAABcIueWUc=
itemType/:itemTypeId/dxf


Response

Code Block
languagejs
{
  "dxf": {...}
  "message": "optional response message"
}


Status

Response codeDescription
200Success
404Not found - a given service identifier was not found




Not acceptable - there was an issue validating the input
Section

Filters
Anchor
FiltersAnchor
FiltersAnchor

 Some endpoint queries require a filter. A filter is basically a JSON object with the following format:

Credentials filter:Response

Code Block
languagejs
  "filter" : {
    "ids" : ["ID1", "ID2", "ID3", ...],
    "type" : "TYPE",
    "messagedescription" : "optionalDESCRIPTION"
 response message"}
}

Status

Note
When using endpoints that use this filter, the filter cannot be empty: at least one field of the filter must be specified.
Response codeDescription
200Success
404Not found - a given workflow identifier was not found
406