StackState API (0.0.1)

Download OpenAPI specification:Download

StackState's API specification

Authentication

ApiToken

Security Scheme Type API Key
Header parameter name: X-API-Token

ServiceToken

Security Scheme Type API Key
Header parameter name: X-API-Key

import

Import settings

Import StackState Templated JSON (STJ) setting nodes.

Authorizations:
query Parameters
timeoutSeconds
integer <int64>
namespace
string
unlocked
string
Enum: "fail" "skip" "overwrite"
Request Body schema: plain/text
string

Responses

Response samples

Content type
application/json
[
  • { }
]

export

Export settings

Export StackState Templated JSON (STJ) setting nodes.

Authorizations:
Request Body schema: application/json
nodesWithIds
Array of integers <int64> [ items <int64 > ]
allNodesOfTypes
Array of strings
namespace
string
allowReferences
Array of strings

Responses

Request samples

Content type
application/json
{
  • "nodesWithIds": [
    ],
  • "allNodesOfTypes": [
    ],
  • "namespace": "string",
  • "allowReferences": [
    ]
}

node

Node API

list all node types

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "nodeTypes": [
    ]
}

Node type API

list all nodes of that type

Authorizations:
path Parameters
nodeType
required
string
query Parameters
namespace
string
ownedBy
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

stackpack

StackPack API

upload a StackPack

Authorizations:
Request Body schema: multipart/form-data
stackPack
string <binary>

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "displayName": "string",
  • "version": "string",
  • "logo": "string",
  • "categories": [
    ],
  • "isNew": true,
  • "overviewUrl": "string",
  • "detailedOverviewUrl": "string",
  • "resourcesUrl": "string",
  • "faqs": [
    ],
  • "configurationUrls": [
    ],
  • "releaseStatus": "AVAILABLE",
  • "isCompatible": true
}

StackPack API

list of stackpack

Authorizations:

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Provision API

Provision details

Authorizations:
path Parameters
stackName
required
string (stackName)
Request Body schema: application/json
property name*
string

Responses

Request samples

Content type
application/json
{
  • "property1": "string",
  • "property2": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "status": "string",
  • "name": "string",
  • "stackPackVersion": "string",
  • "lastUpdateTimestamp": 0
}

Provision API

Provision details

Authorizations:
path Parameters
stackName
required
string
stackId
required
integer <int64>

Responses

Response samples

Content type
application/json
"string"

Upgrade API

Upgrade stackpack

Authorizations:
path Parameters
stackName
required
string
query Parameters
unlocked
required
string

Responses

Response samples

Content type
application/json
"string"

Confirm manual steps

Confirm manual steps of the stackpack

Authorizations:
path Parameters
stackpackName
required
string
stackpackInstanceId
required
integer <int64>

Responses

Response samples

Content type
application/json
"string"

monitor

List monitors

List all available monitor in the system

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "monitors": [
    ]
}

Get a monitor

Returns a monitor full representation

Authorizations:
path Parameters
monitorIdOrUrn
required
string (MonitorIdOrUrn) ^urn:.+|[0-9]+$

The id or identifier (urn) of a monitor

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "identifier": "string",
  • "description": "string",
  • "functionId": 0,
  • "arguments": [
    ],
  • "remediationHint": "string",
  • "intervalSeconds": 0
}

Delete a monitor

Deletes existing monitor

Authorizations:
path Parameters
monitorIdOrUrn
required
string (MonitorIdOrUrn) ^urn:.+|[0-9]+$

The id or identifier (urn) of a monitor

Responses

Response samples

Content type
application/json
{
  • "monitorIdOrUrn": "string",
  • "_type": "InvalidMonitorIdentifier"
}

Run a monitor

Performs a run of a monitor. If 'dryRun' is set, topology state will not be modified.

Authorizations:
path Parameters
monitorIdOrUrn
required
string (MonitorIdOrUrn) ^urn:.+|[0-9]+$

The id or identifier (urn) of a monitor

query Parameters
dryRun
boolean

If set, the topology state will not be modified

Responses

Response samples

Content type
application/json
{
  • "result": { }
}

Get a monitor with stream information

Returns a monitor full representation with the stream status information

Authorizations:
path Parameters
monitorIdOrUrn
required
string (MonitorIdOrUrn) ^urn:.+|[0-9]+$

The id or identifier (urn) of a monitor

Responses

Response samples

Content type
application/json
{
  • "monitor": {
    },
  • "errors": [
    ],
  • "metrics": {
    },
  • "monitorHealthStateStateCount": 0,
  • "topologyMatchResult": {
    }
}

userProfile

Get current user profile

Get current user profile.

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "lastUpdateTimestamp": 0,
  • "name": "string",
  • "description": "string",
  • "identifier": "string",
  • "starredViews": [
    ],
  • "ownedBy": "string"
}

Save current user profile

Save current user profile.

Authorizations:
Request Body schema: application/json
name
required
string
description
string
identifier
string
starredViews
Array of integers <int64> [ items <int64 > ]
ownedBy
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "identifier": "string",
  • "starredViews": [
    ],
  • "ownedBy": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "lastUpdateTimestamp": 0,
  • "name": "string",
  • "description": "string",
  • "identifier": "string",
  • "starredViews": [
    ],
  • "ownedBy": "string"
}

apiToken

Get current user's API tokens

Get all API token of the logged-in user.

Authorizations:

Responses

Response samples

Content type
application/json
[
  • {
    }
]

event

Get events

Gets you a list of events that exist for topology and time selections.

Authorizations:
Request Body schema: application/json
startTimestampMs
required
integer <instant>
endTimestampMs
required
integer <instant>
topologyQuery
required
string
limit
required
integer
playHeadTimestampMs
integer <instant>
rootCauseMode
string (RootCauseMode)
Enum: "no-cause" "cause-only" "full-cause-tree"
eventTypes
Array of strings
eventTags
Array of strings
eventCategories
Array of strings (EventCategory)
Items Enum: "Changes" "Alerts" "Anomalies" "Activities" "Others"
eventSources
Array of strings
object (EventCursor)

Responses

Request samples

Content type
application/json
{
  • "startTimestampMs": 0,
  • "endTimestampMs": 0,
  • "topologyQuery": "string",
  • "limit": 0,
  • "playHeadTimestampMs": 0,
  • "rootCauseMode": "no-cause",
  • "eventTypes": [
    ],
  • "eventTags": [
    ],
  • "eventCategories": [
    ],
  • "eventSources": [
    ],
  • "cursor": {
    }
}

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "total": 0
}

Get single event

Retrieves a specific event by its identifier.

Authorizations:
path Parameters
eventId
required
string (EventId)

The Identifier of an event.

query Parameters
startTimestampMs
required
integer <instant>
endTimestampMs
required
integer <instant>
playHeadTimestampMs
integer <instant>

Responses

Response samples

Content type
application/json
{
  • "identifier": "string",
  • "sourceIdentifier": "string",
  • "elementIdentifiers": [
    ],
  • "elements": [
    ],
  • "source": "string",
  • "category": "Changes",
  • "description": "string",
  • "name": "string",
  • "sourceLinks": [
    ],
  • "data": { },
  • "eventType": "string",
  • "eventTime": 0,
  • "processedTime": 0,
  • "tags": [
    ],
  • "causingEvents": [
    ]
}

Get event types

Get a list of event types for a certain STQL query.

Authorizations:
query Parameters
startTimestampMs
required
integer <instant>
endTimestampMs
required
integer <instant>
topologyQuery
required
string
rootCauseMode
string (RootCauseMode)
Enum: "no-cause" "cause-only" "full-cause-tree"
playHeadTimestampMs
integer <instant>
eventTypes
Array of strings
limit
required
integer
eventCategories
Array of strings (EventCategory)
Items Enum: "Changes" "Alerts" "Anomalies" "Activities" "Others"

The category labels of an event.

eventSources
Array of strings
eventTags
Array of strings
match
string
Default: ""

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "total": 0
}

Get event sources

Get a list of event sources.

Authorizations:
query Parameters
startTimestampMs
required
integer <instant>
endTimestampMs
required
integer <instant>
topologyQuery
required
string
rootCauseMode
string (RootCauseMode)
Enum: "no-cause" "cause-only" "full-cause-tree"
playHeadTimestampMs
integer <instant>
eventTypes
Array of strings
limit
required
integer
eventCategories
Array of strings (EventCategory)
Items Enum: "Changes" "Alerts" "Anomalies" "Activities" "Others"

The category labels of an event.

eventSources
Array of strings
eventTags
Array of strings
match
string
Default: ""

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "total": 0
}

Get event tags

Gets a list of tags that exist in a list of events.

Authorizations:
query Parameters
startTimestampMs
required
integer <instant>
endTimestampMs
required
integer <instant>
topologyQuery
required
string
rootCauseMode
string (RootCauseMode)
Enum: "no-cause" "cause-only" "full-cause-tree"
playHeadTimestampMs
integer <instant>
eventTypes
Array of strings
limit
required
integer
eventCategories
Array of strings (EventCategory)
Items Enum: "Changes" "Alerts" "Anomalies" "Activities" "Others"

The category labels of an event.

eventSources
Array of strings
eventTags
Array of strings
match
string
Default: ""

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "total": 0
}

healthSynchronization

List health sync streams

Status overview of the health synchronization streams.

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Get health sync stream status

Status overview of a single health synchronization stream

Authorizations:
path Parameters
healthStreamUrn
required
string

Urn of the health stream.

Responses

Response samples

Content type
application/json
{
  • "partition": 0,
  • "consistencyModel": "string",
  • "recoverMessage": "string",
  • "globalErrors": [
    ],
  • "aggregateMetrics": {
    },
  • "mainStreamStatus": {
    }
}

Clear health sync stream errors

Clear all errors for a stream and its sub-streams.

Authorizations:
path Parameters
healthStreamUrn
required
string

Urn of the health stream.

Responses

Response samples

Content type
application/json
{
  • "urn": "string",
  • "message": "string"
}

Delete health sync stream

Delete a health synchronization stream. Deletion will not be immediate.

Authorizations:
path Parameters
healthStreamUrn
required
string

Urn of the health stream.

Responses

Response samples

Content type
application/json
{
  • "urn": "string",
  • "message": "string"
}

List health sync sub-streams

Overview of all sub-streams in a certain health stream.

Authorizations:
path Parameters
healthStreamUrn
required
string

Urn of the health stream.

Responses

Response samples

Content type
application/json
{
  • "subStreams": [
    ]
}

List health sync stream check-states

Overview of check-states matched to topology on the main stream.

Authorizations:
path Parameters
healthStreamUrn
required
string

Urn of the health stream.

Responses

Response samples

Content type
application/json
{
  • "matchedCheckStates": 0,
  • "unmatchedCheckStates": [
    ],
  • "multipleMatchesCheckStates": [
    ]
}

Get health sync sub-stream status

Status overview of a single health synchronization sub stream

Authorizations:
path Parameters
healthStreamUrn
required
string

Urn of the health stream.

healthSyncSubStreamId
required
string

Health synchronization sub stream id.

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "metrics": {
    },
  • "subStreamState": {
    },
  • "checkStateCount": 0
}

List health sync sub-stream check-states

Overview of check-states matched to topology on the main stream.

Authorizations:
path Parameters
healthStreamUrn
required
string

Urn of the health stream.

healthSyncSubStreamId
required
string

Health synchronization sub stream id.

Responses

Response samples

Content type
application/json
{
  • "matchedCheckStates": 0,
  • "unmatchedCheckStates": [
    ],
  • "multipleMatchesCheckStates": [
    ]
}

topologySynchronization

Overview of the topology synchronization streams

Overview of the topology synchronization streams

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "streams": [
    ]
}

Overview of a specific Topology Stream, queried by node id or sync identifier

Overview of a specific Topology Stream, queried by node id or sync identifier

Authorizations:
query Parameters
identifier
required
string
identifierType
required
string (IdentifierType)
Enum: "NodeId" "Identifier"

Responses

Response samples

Content type
application/json
{
  • "item": {
    },
  • "errorDetails": [
    ]
}

Metrics of a specific Topology Stream, queried by node id

Metrics of a specific Topology Stream, queried by node id

Authorizations:
query Parameters
identifier
required
string

Responses

Response samples

Content type
application/json
{
  • "bucketSizeSeconds": 0,
  • "latencySeconds": [
    ]
}

Clear all the errors related to a specific sync

Clear all the errors related to a specific sync

Authorizations:
query Parameters
identifier
required
string
identifierType
required
string (IdentifierType)
Enum: "NodeId" "Identifier"

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

scripting

Execute script

Execute a StackState Scripting Language or Template Language script with arbitrary arguments.

Authorizations:
Request Body schema: application/json
timeoutMs
integer
script
required
string
argumentsScript
string

Responses

Request samples

Content type
application/json
{
  • "timeoutMs": 0,
  • "script": "string",
  • "argumentsScript": "string"
}

Response samples

Content type
application/json
{
  • "result": { }
}

server

Get server info

Get information of the StackState information, such as version, deployment mode, etc.

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "version": {
    },
  • "deploymentMode": "Saas"
}

serviceToken

Get service tokens

Get service tokens.

Authorizations:

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create new service token

Create new service token.

Authorizations:
Request Body schema: application/json
name
required
string
expiryDate
integer <int64>
roles
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "expiryDate": 0,
  • "roles": [
    ]
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "token": "string",
  • "expiration": 0
}

Delete service token

Delete service token.

Authorizations:
path Parameters
serviceTokenId
required
integer <int64> (ServiceTokenId)

The identifier of a service token

Responses

Response samples

Content type
application/json
{
  • "_type": "ErrorsResponse",
  • "trackingKey": "string",
  • "serverTimestamp": 0,
  • "errors": [
    ]
}

exportAnomaly

Export anomalies with metric history and feedback

Authorizations:
query Parameters
startTime
required
integer <int64>

Beginning of timerange of to be exported anomalies. Timestamp in unix millis.

endTime
integer <int64>

End of timerange of to be exported anomalies. Timestamp in unix millis.

history
integer <int64>

Amount of historic data, leading up to the anomaly, to be exported. Duration in unix millis.

feedback
required
string
Value: "present"

Type of filtering to do on feedback. Filtering on feedback is currently mandatory, with only the 'present' value being supporeted (feedback is available).

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get the latests metrics

Gets a top 3 metrics for a datapoint, always takes the last 15 minutes before provided timepoint

Authorizations:
path Parameters
componentId
required
integer <int64> (ComponentId)

The Identifier of a component

query Parameters
queryTime
required
integer <instant> (QueryTime)

A Data point for a query either point from timeline or 'now' if livemode

streamIds
required
Array of integers <int64> (StreamIds) [ items <int64 > ]

Ids of streams to query for

Responses

Response samples

Content type
application/json
No sample