Warning

title	Page 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

Section

List workflows

Lists all the workflows configured in the Aspire

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow

Query String Parameters

Name	Type	Required	Description
description	string	Optional	Filter workflows to only those whose description matches the given expression
sparse	boolean	Optional	Only return minimal data such as identifier, description, name etc

Response

Code Block

language	js

{
  "workflow": [{
    "id": "AAABcID5GBc=",
    "description": "Publish to Elasticsearch",
    ...
  },
  {
    "id": "AAABcIueWUc=",
    "description": "Normalise data",
    ...
  }],
  "message": "optional response message"
}

Status

Response code	Description
200	Success

Section

Get a single workflow

Get information about a single workflow in Aspire

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id

Path Parameters

Name	Type	Required	Description
id	string	Required	The id of the workflow to return

Response

Code Block

language	js

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

Status

Response code	Description
200	Success
404	The given workflow id was not found

Section

Add a workflow

Adds a workflow to Aspire

Panel

borderColor	black
bgColor	#fafafb

POST /aspire_api/workflow

Request Body Parameters

Name	Type	Required	Description
description	string	Required	A description of the workflow

Query String Parameters

Name

Type

Required

Description

empty

boolean

Optional

If true, the workflow created will be empty (with no plans).

By default, the following plans will be created:

onScan
onAddUpdate
onDelete
onPublish
onError

Examples

Add a single workflow

Code Block

language	js

{
  "description": "Publish to Elastic"
  ...
}

Response

Code Block

language	js

{
  "service": {
    "id": "AAABcID5GBc=",
    "description": "Publish to Elastic"
    ...
  },
  "message": "optional response message"
}

Status

Response code	Description
201	Created
406	Not acceptable - there was an issue validating the input

Section

Delete workflow(s)

Delete one or more workflow from Aspire.

Panel

borderColor	black
bgColor	#fafafb

DELETE /aspire_api/service/:id

DELETE /aspire_api/service

Path and Request Body Parameters

Name	Type	Required	Description
id	string	Required	The identifier(s) of the workflow(s) to delete

Examples

Delete a single workflow

Code Block

language	js

{
  "id": "AAABcID5GBc="
}

Delete multiple workflows

Code Block

language	js

[{
  "id": "AAABcID5GBc="
},
{
  "id": "AAABcIueWUc="
}]

Delete multiple workflows(alternative form)

Code Block

language	js

{
  "id": ["AAABcID5GBc=", "AAABcIueWUc="]
}

Response

Code Block

language	js

{
  "message": "optional response message"
}

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 a workflow plan

Get a plan from a workflow in Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/:planId

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to return
planId	string	Required	The identifier of the plan to get

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate"
    }
  }
  "message": "optional response message"
}

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 workflow plan(s)

Create one or more workflow plans in Aspire.

Panel

borderColor	black
bgColor	#fafafb

PUT /aspire_api/workflow/:id

PUT /aspire_api/workflow/:id/:planId

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to add a plan to
planId	string	Required	The identifier of the plan to add

Examples

Create a single plan

Code Block

language	js

{
  "id": "onScan"
}

Create multiple plans

Code Block

language	js

[{
  "id": "onScan"
},
{
  "id": "onAddUpdate"
}]

Create multiple plans (alternative version)

Code Block

language	js

{
  "id": ["onScan", "onAddUpdate"]
}

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": ["onScan", "onAddUpdate"]
    }
  }
  "message": "optional response message"
}

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

Delete a workflow plan

Delete a workflow plan from Aspire.

Panel

borderColor	black
bgColor	#fafafb

DELETE /aspire_api/workflow/:id/:planId

Path and Request Body Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to use
planId	string	Required	The identifier of the plan to delete

Response

Code Block

language	js

{
  "message": "optional response message"
}

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 plan item

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

Panel

borderColor	black
bgColor	#fafafb

POST /aspire_api/workflow/:id/:planId/:type

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to return
planId	string	Required	The identifier of the plan to get
type	string	Required	The 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

Item Type	Parameter Name	Parameter Type	Required	Description
Rule	<TODO>
Application Rule
Condition
Exit

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate",
      "rule": {
        "id": "AAABcQwxWUc=",
        ...
      }
    }
  }
  "message": "optional response message"
}

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

Update a workflow plan item

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

PUT /aspire_api/workflow/:id/:planId/:itemId

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to use
planId	string	Required	The identifier of the plan to use
itemId	string	Required	The 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 plan item above

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate",
      "rule": {
        "id": "AAABcQwxWUc=",
        ...
      }
    }
  }
  "message": "optional response message"
}

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

Delete a workflow plan item

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

DELETE /aspire_api/workflow/:id/:planId/:itemId

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow to use
planId	string	Required	The identifier of the plan to use
itemId	string	Required	The identifier of the node item to delete

Response

Code Block

language	js

{
  "message": "optional response message"
}

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

Move a workflow plan item

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

PUT/aspire_api/workflow/:id/:planId/:src/:dest

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow to use
planId	string	Required	The identifier of the plan to use
src	string	Required	The identifier of the plan item to move
dest	string	Required	The identifier of the new parent for the moved item

Response

Code Block

language	js

{
  "message": "optional response message"
}

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 workflow templates

Retrieve all workflow templates from Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/template

Path and Query String Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow to get the templates for
description	string	Optional	Filter workflows to only those whose description matches the given expression

Response

Code Block

language	js

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

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 a workflow template

Retrieve a workflow templates from Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/template/:templateId

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow to get the templates for
templateId	string	Required	The identifier of the template to get

Response

Code Block

language	js

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

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 workflow

plan

rules

Get all the rules for a given workflow.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/rule

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow to return rules for

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate",
      "rule": [{
        "id": "ddSWeq123",
        "description": "Some rule",
        "type": "application",
        ...
      },
      {
        "id": "ddSWeq124",
        "description": "Some rule",
        "type": "groovy",
        ...
      }]
    }
  }
  "message": "optional response message"
}

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 a workflow

plan

rule

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/rule/:ruleId

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow to return rules for
ruleId	string	Required	The identifier of the rule to get

Response

Code Block

language	js

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

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 rule

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

POST /aspire_api/workflow/:id/rule

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow to create a rule for

Request Body Parameters

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

Rule Type	Parameter Name	Parameter Type	Required	Description
groovy	<TODO>
application

Response

Code Block

language	js

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

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

Update a workflow rule

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

POST PUT /aspire_api/workflow/:id/rule/:ruleId

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

Request Body Parameters

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

Response

Code Block

language	js

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

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

Delete workflow

rules <<<<

rule(s)

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

DELETE /aspire_api/workflow/:id/rule

DELETE GET /aspire_api/workflow/:id/rule/:planIdruleId

Path and Request Body Parameters

Name

Type

Required

Description

id

string

Required

The identifier of the workflow from which to delete rule(s)

to return

or the identifier of the rule to delete when used in the body

ruleIdplanId

string

Required

The identifier of the plan rule to getdelete

Examples

Delete a single ruleResponse

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
  
}

Delete multiple rules

Code Block

language	js

[{
  "descriptionid": "Publish to ElasticsearchAAABcIueWUc"
},
{
    "planid": {
    "AAABcIueWac"
}]

Delete multiple rules (alternative version)

Code Block

language	js

{
  "id": ["onAddUpdateAAABcIueWUc", "AAABcIueWac"]
}

Response

Code Block

language	js

{
    }
  }
  "message": "optional response message"
}

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

Copy or Share workflow rules <<<<

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/:planId

Path and Request Body Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to return
planId	string	Required	The identifier of the plan to get

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate"
    }
  }
  "message": "optional response message"
}

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 workflow libraries <<<<

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/:planId

Path and Request Body Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to return
planId	string	Required	The identifier of the plan to get

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate"
    }
  }
  "message": "optional response message"
}

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 a workflow library <<<<

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/:planId

Path and Request Body Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to return
planId	string	Required	The identifier of the plan to get

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate"
    }
  }
  "message": "optional response message"
}

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

Reload workflow libraries <<<<

?? Needed?????

Delete one or more services from Aspire.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire_api/workflow/:id/:planId

Path and Request Body Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the workflow(s) to return
planId	string	Required	The identifier of the plan to get

Response

Code Block

language	js

{
  "workflow": {
    "id": "AAABcIueWUc=",
    "description": "Publish to Elasticsearch"
    "plan": {
      "id": "onAddUpdate"
    }
  }
  "message": "optional response message"
}

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

Page tree

Versions Compared

Old Version 6

New Version 7

Key

List workflows

Get a single workflow

Add a workflow

Delete workflow(s)

Get a workflow plan

Create workflow plan(s)

Delete a workflow plan

Create a workflow plan item

Update a workflow plan item

Delete a workflow plan item

Move a workflow plan item

Get workflow templates

Get a workflow template

Get workflow

rules

Get a workflow

rule

Create a workflow rule

Update a workflow rule

Delete workflow

rule(s)

Copy or Share workflow rules <<<<

Get workflow libraries <<<<

Get a workflow library <<<<

Reload workflow libraries <<<<

Page tree

Page History

Versions Compared

Old Version 6

New Version 7

Key

List workflows

Get a single workflow

Add a workflow

Delete workflow(s)

Get a workflow plan

Create workflow plan(s)

Delete a workflow plan

Create a workflow plan item

Update a workflow plan item

Delete a workflow plan item

Move a workflow plan item

Get workflow templates

Get a workflow template

Get workflow

rules

Get a workflow

rule

Create a workflow rule

Update a workflow rule

Delete workflow

rule(s)

Copy or Share workflow rules <<<<

Get workflow libraries <<<<

Get a workflow library <<<<

Reload workflow libraries <<<<