Issues
Retrieve a list of issues.
Required scope: alerts:read
query Parameters
operatorIdRestrict to a sub-operator. Required when your consumer has access to more than one operator and none is implied by your credentials.
statusFilter by issue status.
lastEventFromOnly include issues with an event at or after this time.
Retrieve a list of issues. › Responses
get-issues 200 response
Report an issue.
The scope, team and site must belong to the operator the issue is created under.
Required scope: alerts:write
Report an issue. › Request Body
typeThe issue type token.
What a new alert or issue is about.
operatorIdOperator to create the issue under. Defaults to your own operator.
teamIdTeam the issue belongs to, if any. Must belong to the same operator.
siteIdSite the issue belongs to, if any. Must belong to the same operator.
Report an issue. › Responses
post-issue 200 response
idId of the issue.
typeThe issue-type token.
What an alert or issue is about.
statusCurrent status of the issue.
operatorIdId of the operator this issue belongs to.
teamIdId of the team this issue is scoped to, when service-alerts exposes it. Null today.
siteIdId of the site this issue is scoped to, when service-alerts exposes it. Null today.
eventCountNumber of events attached to this issue.
firstEventAtEarliest event on this issue, if any.
lastEventAtMost recent event on this issue, if any.
resolvedAtWhen this issue was resolved, if it has been.
Retrieve a single issue, including its recent events.
page/perPage paginate the embedded events. Required scope: alerts:read
path Parameters
issueIdquery Parameters
operatorIdRetrieve a single issue, including its recent events. › Responses
get-issue 200 response
idId of the issue.
operatorIdtypeWhat an alert or issue is about.
statuseventCountDay-bucketed event counts for this issue.
Events attached to this issue, most recent first.
teamIdsiteIdfirstEventAtlastEventAtresolvedAtRetrieve the comments on an issue.
Required scope: alerts:read
path Parameters
issueIdquery Parameters
operatorIdRetrieve the comments on an issue. › Responses
get-issue-comments 200 response
Comment on an issue.
Required scope: alerts:write
path Parameters
issueIdquery Parameters
operatorIdComment on an issue. › Request Body
bodyComment body, at most 5000 characters.
Comment on an issue. › Responses
post-issue-comment 200 response
idId of the comment.
authorNameDisplay name of the author.
bodyComment body.
createdAtWhen the comment was posted.
authorIdAuthor's user id, if known.
Resolve an issue.
Required scope: alerts:write
path Parameters
issueIdquery Parameters
operatorIdResolve an issue. › Responses
resolve-issue 200 response
idId of the issue.
typeThe issue-type token.
What an alert or issue is about.
statusCurrent status of the issue.
operatorIdId of the operator this issue belongs to.
teamIdId of the team this issue is scoped to, when service-alerts exposes it. Null today.
siteIdId of the site this issue is scoped to, when service-alerts exposes it. Null today.
eventCountNumber of events attached to this issue.
firstEventAtEarliest event on this issue, if any.
lastEventAtMost recent event on this issue, if any.
resolvedAtWhen this issue was resolved, if it has been.
Retrieve the event-source breakdown for an issue.
Required scope: alerts:read
path Parameters
issueIdquery Parameters
operatorIdRetrieve the event-source breakdown for an issue. › Responses
get-issue-sources 200 response