evalink talos
  • evalink talos API Documentation
  • Get started
    • 1. Create a free evalink talos account
    • 2. Create a test set-up in evalink talos
    • 3. About REST – The Basics
    • 4. Get Postman
    • 5. Create your first API Token in evalink talos
    • 6. Make your first REST API call
  • Alarm API
    • Send alarms using simple webhooks
    • Send alarms with content using webhooks and header attachments
    • Send alarms using REST
    • Query alarms
  • Management API
    • Manage users
    • Manage devices
    • Manage groups
    • Manage contacts
    • Manage schedules
    • Manage virtual receivers
    • Manage webhooks
    • Manage workflows
Powered by GitBook
On this page
  • Introduction
  • create a new workflow from a template
  • list the workflow's template by companyId
  • list the workflow by the alarmId
  • delete the workflow by its id
  • update the workflow by its id

Was this helpful?

  1. Management API

Manage workflows

Use this section to manage, update, create and delete workflows. Workflows define standard actions that need to be taken in case of an alarm.

Introduction

Managed workflows allow you to define & manage your workflows globally and selectively link them to specific sites.

Global workflows are only used as a fallback option when there is no workflow defined on-site level for a specific.

create a new workflow from a template

POST https://talos-app.io/api/workflow-service/workflows/create-from-template

Use this endpoint to create a new workflow from a new template.

Headers

Name
Type
Description

Authorization

string

Use "Bearer" followed by your API Token.

Request Body

Name
Type
Description

userId

string

The needed userId

workflowTemplateId

string

The Id of the template you will create.

alarmId

string

The alarmId related to this template.

list the workflow's template by companyId

GET https://talos-app.io/api/workflow-service/workflow-templates/search/findByCompanyId{companyId}

Use this endpoint to get the templates by their companyId

Path Parameters

Name
Type
Description

companyId

string

The companyId of the company.

Headers

Name
Type
Description

Authorization

string

Use "Bearer" followed by your API-Token

list the workflow by the alarmId

GET https://talos-app.io/api/workflow-service/workflows/search/findByAlarmId

Use this endpoint to get workflows by their alarmId.

Path Parameters

Name
Type
Description

Authorization

string

Use "Bearer" followed by your API-Token

Query Parameters

Name
Type
Description

alarmId

string

The alarmId of the needed alarm.

{
  "alarmAttachmentStrategy": "NEVER",
  "alarmId": "string",
  "automated": true,
  "companyId": "string",
  "createdDate": 0,
  "deviceGroupId": "string",
  "deviceId": "string",
  "editingUserId": "string",
  "entityStatus": "string",
  "id": "string",
  "links": {
    "empty": true
  },
  "outcome": "string",
  "outcomeList": "string",
  "parkedUntil": 0,
  "reportingMode": "EVENT_LOG_ONLY",
  "rootBlockId": "string",
  "shortId": "string",
  "workflowStatus": "ABORTED",
  "workflowTemplateId": "string",
  "workflowTemplateName": "string"
}

delete the workflow by its id

DELETE https://talos-app.io/api/workflow-service/workflows/{id}

Use this endpoint to delete a workflow using its id.

Path Parameters

Name
Type
Description

id

string

The needed id

Headers

Name
Type
Description

Authorization

string

Use "Bearer" followed by your API-Token

update the workflow by its id

PATCH https://talos-app.io/api/workflow-service/workflows/{id}

It updates the workflow by its Id.

Path Parameters

Name
Type
Description

id

string

The needed Id

Headers

Name
Type
Description

Authorization

string

Use "Bearer" followed by the API-Token

Request Body

Name
Type
Description

deviceId

string

The Id of the device

companyId

string

The Id of the company

alarmId

string

The Id of the alarm

{
  "alarmAttachmentStrategy": "NEVER",
  "alarmId": "string",
  "automated": true,
  "companyId": "string",
  "createdDate": 0,
  "deviceGroupId": "string",
  "deviceId": "string",
  "editingUserId": "string",
  "id": "string",
  "outcome": "string",
  "outcomeList": "string",
  "parkedUntil": 0,
  "reportingMode": "EVENT_LOG_ONLY",
  "rootBlockId": "string",
  "shortId": "string",
  "workflowStatus": "ABORTED",
  "workflowTemplateId": "string",
  "workflowTemplateName": "string"
}
PreviousManage webhooks

Last updated 4 years ago

Was this helpful?