DFS v26.1
Loading
API docs by Redocly

DFS Alerting API (latest)

Download OpenAPI specification:

Contains methods to manage alerts

Alerts

Get alert by its id

Authorizations:
Bearer
path Parameters
alertId
required
integer <int32>

Alert id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "productIds": [
    ],
  • "isActive": true,
  • "owner": "string"
}

Get condition details by its id

Authorizations:
Bearer
path Parameters
conditionId
required
integer <int32>

Condition id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "objectGraphDataSource": "string",
  • "alertDefinitionId": 0,
  • "hasCustomScript": true,
  • "objectGraphNavigationPathLeft": "string",
  • "objectGraphNavigationPathRight": "string",
  • "objectGraphRootNode": "string",
  • "operator": "string",
  • "testingOperator": "string",
  • "threshold": 0.1
}

Updates condition by its id

Authorizations:
Bearer
path Parameters
conditionId
required
integer <int32>

The condition id to update

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The condition data to use for update

id
integer <int32>
objectGraphDataSource
string or null
alertDefinitionId
integer <int32>
hasCustomScript
boolean
objectGraphNavigationPathLeft
string or null
objectGraphNavigationPathRight
string or null
objectGraphRootNode
string or null
operator
string or null
testingOperator
string or null
threshold
number or null <double>

Responses

Request samples

Content type
{
  • "id": 0,
  • "objectGraphDataSource": "string",
  • "alertDefinitionId": 0,
  • "hasCustomScript": true,
  • "objectGraphNavigationPathLeft": "string",
  • "objectGraphNavigationPathRight": "string",
  • "objectGraphRootNode": "string",
  • "operator": "string",
  • "testingOperator": "string",
  • "threshold": 0.1
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Get conditions by alert id

Authorizations:
Bearer
path Parameters
alertId
required
integer <int32>

Alert id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Search alerts

Searches for alerts based on specified conditions and gets a paged list of matching alerts in the system

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The parameter DTO

sortColumnName
string (AlertSortableColumn)
Enum: "Id" "Name" "IsActive" "CreatedBy"
sortDirection
string (SortDirection)
Enum: "Asc" "Desc"
searchTerm
string or null

Search term to look for

page
integer <int32>

The result page number, starting by 1

pageSize
integer <int32>

The number of items in a result page

Responses

Request samples

Content type
{
  • "sortColumnName": "Id",
  • "sortDirection": "Asc",
  • "searchTerm": "string",
  • "page": 0,
  • "pageSize": 0
}

Response samples

Content type
application/json
{
  • "alerts": [
    ],
  • "totalNumberOfResults": 0
}