openapi: 3.1.0 info: version: 3.0.0 title: Alerts/Incidents API description: 'This API enables you to retrieve and update alerts and incidents, and other APIs relating to them' termsOfService: 'https://www.moogsoft.com/legal-information/express-terms-conditions/' contact: name: API Support url: 'https://docs.moogsoft.com/en/moogsoft-apis.html' email: support@moogsoft.com license: url: 'https://www.moogsoft.com/legal-information' name: Apex AIOps Incident Management Proprietary servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' paths: /v2/alerts/columns: get: tags: - Alert Columns Resource V 2 summary: Get column names of alert DTO. description: Column names for filtering alerts via /alerts endpoint operationId: alertDtoColumnNames responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseColumnsDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v2/autoclose-config: get: tags: - autoclose-config summary: Get autoclose configs description: 'Get autoclose configs for alert, incident, or both' operationId: getAutoCloseConfig parameters: - name: type in: query schema: type: string description: 'Type of configuration to retrieve (incident or alert), retrieves both types if empty' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfAutoCloseConfigDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:view' description: Required user permissions for this endpoint '/v2/autoclose-config/{id}': patch: tags: - autoclose-config summary: Update autoclose config description: Update autoclose config for alerts or incidents. operationId: patchAutoCloseConfig parameters: - name: id in: path required: true schema: type: string requestBody: description: Configs used to update existing configs. required: true content: application/json: schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAutoCloseConfigDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:edit' description: Required user permissions for this endpoint /v2/autoclose-policy: get: tags: - autoclose-policy summary: Get autoclose policies description: 'Get autoclose policies for alert, incident, or both' operationId: getAutoClosePolicies parameters: - name: type in: query schema: type: string description: 'Type of policy to retrieve (incident or alert), retrieves both types if empty' default: '' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfAutoClosePolicyDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:view' description: Required user permissions for this endpoint post: tags: - autoclose-policy summary: Create autoclose policy description: Create autoclose policy for alerts or incidents. operationId: postAutoClosePolicy requestBody: description: Settings used to create new policy required: true content: application/json: schema: $ref: '#/components/schemas/BaseAutoClosePolicyDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAutoClosePolicyDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:edit' description: Required user permissions for this endpoint '/v2/autoclose-policy/{id}': patch: tags: - autoclose-policy summary: Update autoclose policy description: Update autoclose policy for alerts or incidents. operationId: patchAutoClosePolicy parameters: - name: id in: path required: true schema: type: string requestBody: description: Settings used to update existing policies. required: true content: application/json: schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAutoClosePolicyDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:edit' description: Required user permissions for this endpoint get: tags: - autoclose-policy summary: Get autoclose policy description: Get autoclose policy by id operationId: getAutoClosePolicy parameters: - name: id in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAutoClosePolicyDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:view' description: Required user permissions for this endpoint delete: tags: - autoclose-policy summary: Delete autoclose policy description: Delete autoclose policy with specified id operationId: deleteAutoClosePolicy parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:edit' description: Required user permissions for this endpoint /v2/event-columns: get: tags: - event-columns summary: get columns names of Event description: get columns names of Event operationId: eventDtoColumnNames responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseColumnsDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint /v2/incidents/columns: get: tags: - incident columns resource summary: Get column names of IncidentDTO. description: 'Column names for filtering alerts in outbound integrations, returns a list of strings' operationId: incidentDtoColumnNames responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseColumnsDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint '/v2/situation-room/{incidentId}/alerts': post: tags: - alerts summary: 'Get alerts for an incident, for the situation room' description: 'Get alerts for an incident, for the situation room' operationId: getSituationRoomAlertsV2 parameters: - name: incidentId in: path required: true schema: type: integer format: int64 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SituationRoomAlertsRequestV2' __errors__: '#/components/schemas/ColumnFilterMap': No foreign doc with id components found responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseSituationRoomAlertList' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v2/stats/overview: get: tags: - overviewStats summary: Get overview statistics for dashboard description: Get overview statistics for dashboard operationId: getOverviewStats parameters: - name: activeOnly in: query description: active only schema: type: boolean default: 'false' - name: end in: query description: end time schema: type: integer format: int64 exclusiveMinimum: 0 - name: start in: query description: time used to filter out the Opensearch data schema: type: integer format: int64 exclusiveMinimum: 0 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseOverviewWebResponse' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' /v3/service/summary: post: tags: - dashboardSummaryPost summary: Get alert/incident summary for dashboard description: Get alert/incident summary for dashboard operationId: getServiceSummaryPost requestBody: description: Dashboard Summary request required: true content: application/json: schema: $ref: '#/components/schemas/DashboardSummaryRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentSummaryResponse' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint /v1/alert-workflows/dependent-on: get: tags: - alert-workflows summary: Checks for any alert workflows dependent on a specific resource. description: Checks for any alert workflows dependent on a specific resource. operationId: getAlertWorkflowsDependentOnResource parameters: - name: resource_name in: query required: true schema: type: string pattern: \S - name: resource_type in: query required: true schema: $ref: '#/components/schemas/ResourceType' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfWorkflowDependentOnResponseDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint '/v1/alerts/{alertId}/external-ids/{integrationId}': get: tags: - alerts summary: Get details associated with specific external system. description: Get details associated with a specific external system in the alert. Returns the systemName and all the details operationId: getAlertExternalId parameters: - name: alertId in: path description: alert ID required: true schema: type: integer format: int64 exclusiveMinimum: 0 - name: integrationId in: path description: integration ID required: true schema: type: string minLength: 1 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseExternalSystemDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint patch: tags: - alerts summary: Add externalID information to an alert. description: Add details about an external system to the alert operationId: patchAlertExternalId parameters: - name: alertId in: path description: alert ID required: true schema: type: integer format: int64 exclusiveMinimum: 0 - name: integrationId in: path description: integration ID required: true schema: type: string minLength: 1 requestBody: description: Configs used to update existing configs. required: true content: application/json: schema: $ref: '#/components/schemas/ExternalSystemDto' responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:edit' description: Required user permissions for this endpoint delete: tags: - alerts summary: Delete externalID information to an alert. description: Delete details about an external system in the alert operationId: deleteAlertExternalId parameters: - name: alertId in: path description: alert ID required: true schema: type: integer format: int64 exclusiveMinimum: 0 - name: integrationId in: path description: integration ID required: true schema: type: string minLength: 1 responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:edit' description: Required user permissions for this endpoint post: tags: - alerts summary: Add externalID information to an alert. description: Add details about an external system to the alert operationId: postAlertExternalId parameters: - name: alertId in: path description: alert ID required: true schema: type: integer format: int64 exclusiveMinimum: 0 - name: integrationId in: path description: integration ID required: true schema: type: string minLength: 1 requestBody: description: Configs used to update existing configs. required: true content: application/json: schema: $ref: '#/components/schemas/ExternalSystemDto' responses: '201': description: Created '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:edit' description: Required user permissions for this endpoint /v1/alert-workflows/validate: post: tags: - alert-workflows summary: Validates an alert workflows. description: Validates an alert workflow. operationId: validateAlertWorkflow requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BaseWorkflowDto' responses: '201': description: Created '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'workflows:edit' description: Required user permissions for this endpoint /v1/automation-config: patch: tags: - automation-config summary: Update automation config for auto close of alerts and incidents. description: Update automation config for auto close of alerts and incidents. operationId: patchAutomationConfig requestBody: description: Configs used to update existing configs. required: true content: application/json: schema: $ref: '#/components/schemas/AutomationConfigDto' responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:edit' description: Required user permissions for this endpoint get: tags: - automation-config summary: Get automation config for auto close of alerts and incidents. description: Get automation config for auto close of alerts and incidents. operationId: getAutomationConfig responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAutomationConfigDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'automation:view' description: Required user permissions for this endpoint '/v1/incidents/{incidentId}/comments': get: tags: - incident-comments summary: Get all comments of an existing incident operationId: getComments parameters: - name: incidentId in: path description: ID of the incident to return list of comments. Returns 400 (Invalid ID Supplied) if this value is anything other than a non-negative integer. required: true schema: type: integer format: int64 exclusiveMinimum: 0 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentCommentResponse' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint post: tags: - incident-comments summary: Add comment to existing incident operationId: addComment parameters: - name: incidentId in: path description: Incident id required: true schema: type: integer format: int64 requestBody: description: Incident comment to be added required: true content: application/json: schema: $ref: '#/components/schemas/CommentRequestDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentCommentDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint /v1/alerts-search: get: tags: - alerts-search summary: Search for alerts for given namespace description: Search for alerts matching the following criteria. operationId: search parameters: - name: namespace in: query description: Namespace of the alerts to search required: true schema: type: string minLength: 1 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfinteger' __errors__: '#/components/schemas/MoogResponseListOfinteger': No foreign doc with id components found '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/alert-workflows/test/bulk: post: tags: - alert-workflows summary: 'Tests alert workflows, in bulk.' description: 'Tests alert workflows, in bulk.' operationId: testAlertWorkflows requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BulkTestWorkflowDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfBulkTestWorkflowResultsDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'workflows:edit' description: Required user permissions for this endpoint /v1/incident-workflows/validate: post: tags: - incident-workflows summary: Validates an incident workflow. description: Validates an incident workflow. operationId: validateIncidentWorkflow requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BaseWorkflowDto' responses: '201': description: Created '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'workflows:edit' description: Required user permissions for this endpoint '/v1/incidents/{incidentId}': put: tags: - incidents summary: Update incident information. description: Update incident information. operationId: updateIncidentPut parameters: - name: incidentId in: path description: Id of the incident that is being updated required: true schema: type: integer format: int64 requestBody: description: Update payload for the incident required: true content: application/json: schema: $ref: '#/components/schemas/PatchPayloadDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint patch: tags: - incidents summary: Update the incident to the given status and/or assignee. description: Update the incident to the given status and/or assignee. operationId: updateIncident parameters: - name: incidentId in: path description: Id of the incident that is being updated required: true schema: type: integer format: int64 requestBody: description: JSON Patch payload for the incident required: true content: application/json: schema: $ref: '#/components/schemas/PatchPayloadDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint get: tags: - incidents summary: Get incident by id. description: Get incident by id. operationId: getIncident parameters: - name: incidentId in: path description: Id of the incident that is being retrieved required: true schema: type: integer format: int64 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint '/v1/alerts/{alert_id}/events-timeline': get: tags: - alerts summary: List the event timeline buckets associated with the specified alert description: 'Get the event timeline buckets that represent the count of event severities, for specified interval and start time' operationId: getEventTimelineByAlertId parameters: - name: bucket_interval in: query description: Time interval of each bucket (in seconds). required: true schema: type: integer format: int64 exclusiveMinimum: 0 examples: - 3600 examples: default: value: 3600 - name: bucket_start_time in: query description: 'Start time of the first bucket. If it is not provided, the default will be considered as the first_event_time.' schema: type: integer format: int64 examples: - 1720083965000 examples: default: value: 1720083965000 - name: alert_id in: path description: 'ID of the alert to use, returns 404 if there is no alert for the alertId.' required: true schema: type: integer format: int64 exclusiveMinimum: 0 examples: - 1 examples: default: value: 1 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfEventTimelineBucket' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/operational-stats: post: tags: - operationalStats summary: Provides details for operational stats in executive summary description: Returns incident trend and time to resolve chart details operationId: 'getOperationalStats,' requestBody: description: Operational stats request required: true content: application/json: schema: $ref: '#/components/schemas/OperationalStatsRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseOperationalStatsWebResponse' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint /v1/incident-workflows/dependent-on: get: tags: - incident-workflows summary: Checks for any alert workflows dependent on a specific resource. description: Checks for any alert workflows dependent on a specific resource. operationId: getIncidentWorkflowsDependentOnResource parameters: - name: resource_name in: query required: true schema: type: string pattern: \S - name: resource_type in: query required: true schema: $ref: '#/components/schemas/ResourceType' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfWorkflowDependentOnResponseDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint '/v1/alerts/{alertId}/snapshot': get: tags: - alerts summary: 'Get an alert snapshots, with highest severity.' description: The alert returned is a snapshot of the earliest and highest severity. operationId: getAlertSnapshot parameters: - name: alertId in: path description: ID of the alert to use. Returns 404 if there is no alert for the alertId. required: true schema: type: integer format: int64 exclusiveMinimum: 0 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAlertDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/incidents: patch: tags: - incidents summary: Update multiple incidents to the given status and/or assignee. description: Update the incidents to the given status and/or assignee. operationId: updateIncidents requestBody: description: Bulk update payload for the incidents required: true content: application/json: schema: $ref: '#/components/schemas/BulkPatchPayloadDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfIncidentDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint get: tags: - incidents summary: List incidents that match the given filter. description: 'List incidents that match the given filter. Note that all GET requests are limited to a maximum of 10,000 items per query.' operationId: listIncidents parameters: - name: User-Agent in: header schema: type: string - name: filter in: query description: Query string to filter the incidents by. The string must be in AIOps query language. You may use any of the columns for filtering. schema: type: string examples: - 'class in (Middleware, Hardware)' examples: default: value: 'class in (Middleware, Hardware)' - name: jsonFilter in: query description: 'Return only incidents that match this AG-Grid-style JSON filter, such as {"status":{"values":["open","in progress","resolved"],"filterType":"set"}}' deprecated: true schema: type: string - name: jsonSort in: query description: 'Sort the results according to this AG-Grid-style JSON sort info, such as [{"sort":"asc","colId":"severity"}]' deprecated: true schema: type: string - name: keyword in: query description: Return only incidents that contain these keywords. deprecated: true schema: type: string examples: - support examples: default: value: support - name: limit in: query description: 'Number of incidents to fetch, after skipping the number specified in the ''start'' parameter if any. Between 1 and 5000' schema: type: integer format: int32 exclusiveMinimum: 0 maximum: 5000 default: '100' examples: - 100 examples: default: value: 100 - name: start in: query description: 'Number of incidents to skip. That is, the first incident returned will be object # start + 1.' schema: type: integer format: int32 minimum: 0 default: '0' examples: - 0 examples: default: value: 0 - name: utcOffset in: query description: The difference in hours from Coordinated Universal Time (UTC) to user's local time. schema: type: string default: GMT examples: - 'GMT-7/GMT+7:30' examples: default: value: 'GMT-7/GMT+7:30' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentList' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint post: tags: - incidents summary: Get a list of all incidents with matching criteria. description: 'Get a list of all incidents with matching criteria. Note that all POST requests are limited to a maximum of 10,000 items per query.' operationId: listIncidentsPost requestBody: description: List incidents request specification required: true content: application/json: schema: $ref: '#/components/schemas/ListIncidentsRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentList' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint /v1/incident-workflows/test: post: tags: - incident-workflows summary: Tests an incident workflow. description: Tests an incident workflow. operationId: testIncidentWorkflow requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WorkflowTestWrapperDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfWorkflowTestResultDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'workflows:edit' description: Required user permissions for this endpoint /v1/alert-workflows/standalone: post: tags: - alert-workflows summary: Invokes the given standalone workflow on a single alert. description: Invokes the given standalone workflow on a single alert. operationId: invokeAlertStandaloneWorkflow requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/StandaloneWorkflowInvocationRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseVoid' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:edit' description: Required user permissions for this endpoint /v1/incident-filters/columns: get: tags: - incident-filters summary: Get column names available for use with incident filters. description: 'Column names for filtering incidents in workflows, outbound integrations, etc.' operationId: incidentFilterColumnNames responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseColumnsDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint '/v1/alerts/{alertId}': patch: tags: - alerts summary: Update the "status" or "assignee" or "assigned_groups" field in a specific alert. description: Updates a single alert. operationId: updateAlert parameters: - name: alertId in: path required: true schema: type: integer format: int64 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AlertUpdateRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAlertDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:edit' description: Required user permissions for this endpoint get: tags: - alerts summary: Get details of the alert with the specified ID. description: Returns a single alert. operationId: alertDetails parameters: - name: User-Agent in: header schema: type: string - name: alertId in: path description: ID of the alert to return. Returns 400 (Invalid ID Supplied) if this value is anything other than a non-negative integer. required: true schema: type: integer format: int64 exclusiveMinimum: 0 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAlertDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/alert-workflows/inputs: get: tags: - alert-workflows summary: Returns inputs previously seen at the input of alert workflow engine. description: Returns inputs previously seen at the input of alert workflow engine. operationId: getRecentAlerts parameters: - name: entryFilter in: query schema: type: string description: Entry filter for the workflow (can be empty) - name: limit in: query schema: type: integer description: Maximum number of previously stored inputs to return format: int32 minimum: 1 default: 100 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfRecentInputDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint /v1/alert-filters/validate: post: tags: - alert-filters summary: Validate Alert Filter operationId: validateAlertFilter requestBody: required: true content: application/json: schema: type: array minItems: 1 items: $ref: '#/components/schemas/FilterStringDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseFilterStringResultDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint /v1/incident-tags-config: patch: tags: - incident-tags-config summary: Update tags config for incidents. description: Update tags config for incidents. operationId: patchIncidentTagsConfig requestBody: description: Configs used to update existing configs. required: true content: application/json: schema: $ref: '#/components/schemas/IncidentTagsConfigDto' responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incident-config:edit' description: Required user permissions for this endpoint get: tags: - incident-tags-config summary: Get tags config for incidents. description: Get tags config for incidents. operationId: getIncidentTagsConfig responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentTagsConfigDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incident-config:view' description: Required user permissions for this endpoint '/v1/alerts/{alertId}/tags': patch: tags: - alerts summary: Overwrite the tags of an alert with the supplied tags. description: Updates the tags of an alert. operationId: updateAlertTags parameters: - name: alertId in: path required: true schema: type: integer format: int64 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SetAlertTagsPayloadDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAlertDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:edit' description: Required user permissions for this endpoint /v1/incident-workflows/test/bulk: post: tags: - incident-workflows summary: 'Tests incident workflows, in bulk.' description: 'Tests incident workflows, in bulk.' operationId: testIncidentWorkflows requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BulkTestWorkflowDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfBulkTestWorkflowResultsDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'workflows:edit' description: Required user permissions for this endpoint '/v1/incidents/{incidentId}/comments/{commentId}': patch: tags: - incident-comments summary: update existing comment operationId: updateComment parameters: - name: commentId in: path description: Comment id required: true schema: type: string - name: incidentId in: path description: Incident id required: true schema: type: integer format: int64 requestBody: description: Incident comment to be updated required: true content: application/json: schema: $ref: '#/components/schemas/CommentRequestDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentCommentDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint delete: tags: - incident-comments summary: Delete comment of an incident operationId: deleteComment parameters: - name: commentId in: path description: Comment ID required: true schema: type: string - name: incidentId in: path description: Incident ID required: true schema: type: integer format: int64 responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint /v1/alert-filters/columns: get: tags: - alert-filters summary: Get column names available for use with alert filters. description: 'Column names for filtering alerts in workflows, outbound integrations, etc.' operationId: alertFilterColumnNames responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseColumnsDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint '/v1/alerts/{alert_id}/events': get: tags: - alerts summary: List event by alertId with given timeline description: Get event details for given filter and pagination parameters operationId: listEventsByAlertId parameters: - name: end_time in: query description: End time to fetch events up to. If not provided then consider alert's last event time as default schema: type: integer format: int64 examples: - 1720083965000 examples: default: value: 1720083965000 - name: limit in: query description: Maximum number of events to return per page. schema: type: integer format: int32 exclusiveMinimum: 0 maximum: 1000 default: 1000 examples: - 1000 examples: default: value: 1000 - name: offset in: query description: Number of events to skip schema: type: integer format: int32 minimum: 0 default: 0 examples: - 0 examples: default: value: 0 - name: start_time in: query description: Start time to fetch events from. schema: type: integer format: int64 examples: - 1720083965000 examples: default: value: 1720083965000 - name: alert_id in: path description: ID of the alert to use. Returns 404 if there is no alert for the alertId. required: true schema: type: integer format: int64 exclusiveMinimum: 0 examples: - 1 examples: default: value: 1 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseEventList' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint '/v1/alerts/{alertId}/external-ids': get: tags: - alerts summary: Get all externalIds associated with the alert. description: Get all externalIds associated with the alert. Returns the systemName and all the details operationId: getAllAlertExternalIds parameters: - name: alertId in: path description: alert ID required: true schema: type: integer format: int64 exclusiveMinimum: 0 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfExternalSystemDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/situation-room/columns: get: tags: - Situation Room Resource summary: Get column names of situation room alert DTO. description: Column names for filtering situation room alerts operationId: situationAlertDtoColumnNames responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseColumnsDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/alerts/snapshot: post: tags: - alerts summary: 'Get a list of alert snapshots, with highest severity.' description: Each alert returned is a snapshot of the earliest and highest severity. operationId: listAlertSnapshots requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ListSnapshotRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAlertList' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint '/v1/situation-room/{incidentId}/alerts/unlabeled': get: tags: - alerts summary: 'Get alerts for an incident, that are unlabeled' description: Get alerts for an incident as recommended alerts to take action on operationId: getUnlabeledAlerts parameters: - name: limit in: query schema: type: integer format: int32 exclusiveMinimum: 0 default: 100 - name: rc_bucket in: query schema: $ref: '#/components/schemas/PrcBucket' - name: sort_by in: query required: true schema: type: string enum: - rc_probability - rc_bucket description: Specifies the sort criteria to use pattern: ^(rc_probability|rc_bucket)$ default: rc_probability - name: sort_order in: query required: true schema: type: object description: Sort order default: desc - name: incidentId in: path required: true schema: type: integer format: int64 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseSituationRoomAlertList' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/situation-room/alerts/unlabeled: post: tags: - alerts summary: 'Get total count of unlabeled incidents/alerts, for a set of incidents' description: 'Count number of incidents and alerts that are unlabeled, given a set of incident IDs' operationId: getUnlabeledCount requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UnlabeledRequestDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseUnlabeledResponseDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/alerts: patch: tags: - alerts summary: Update the "status" or "assignee" or "assigned_groups" field in multiple alerts. description: Updates bulk alerts. operationId: updateAlerts requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BulkAlertUpdateRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfAlertDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:edit' description: Required user permissions for this endpoint post: tags: - alerts summary: Get a list of all alerts with matching criteria. description: 'Get a list of all alerts with matching criteria. Note that all POST requests are limited to a maximum of 10,000 items per query.' operationId: listAlertsPost requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ListAlertsRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAlertList' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint get: tags: - alerts summary: Get a list of all alerts with matching criteria. description: 'Get a list of all alerts with matching criteria. Note that all GET requests are limited to a maximum of 10,000 items per query.' operationId: listAlerts parameters: - name: User-Agent in: header schema: type: string - name: filter in: query description: Return only alerts that match this filter.
Returns **400 (Invalid parameters)** if the filter format is invalid. schema: type: string examples: - '''event count'' > 3 AND severity in (Critical, Major, Minor, Warning)' examples: default: value: '''event count'' > 3 AND severity in (Critical, Major, Minor, Warning)' - name: jsonFilter in: query description: 'Return only alerts that match this AG-Grid-style JSON filter, such as {"status":{"values":["open","in progress","resolved"],"filterType":"set"}}' deprecated: true schema: type: string - name: jsonSort in: query description: 'Sort the results according to this AG-Grid-style JSON sort info, such as [{"sort":"asc","colId":"severity"}]' deprecated: true schema: type: string - name: keyword in: query description: Return only alerts that contain these keywords. schema: type: string examples: - compute examples: default: value: compute - name: limit in: query description: Maximum number of alerts to return. This is equivalent to the maximum number of alerts per page. Between 1 and 5 schema: type: integer format: int32 exclusiveMinimum: 0 maximum: 5000 default: 100 examples: - 100 examples: default: value: 100 - name: start in: query description: 'The starting offset of alerts to retrieve. The initial offset to use is 0 and thereafter is typically multiples of ''limit''. NOTE: ''start'' + ''limit'' must not exceed 10,000 -- use ''searchAfter'' with the listAlertsPost operation instead.' schema: type: integer format: int32 minimum: 0 default: 0 examples: - 0 examples: default: value: 0 - name: utcOffset in: query description: UTC Offset schema: type: string default: GMT-0 examples: - GMT-0 examples: default: value: GMT-0 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseAlertList' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint '/v1/incidents/{incidentId}/external-ids': get: tags: - incidents summary: Get all externalIds associated with the incident. description: Get all externalIds associated with the incident. Returns the systemName and all the details operationId: getAllIncidentExternalIds parameters: - name: incidentId in: path description: incident ID required: true schema: type: integer format: int64 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfExternalSystemDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint '/v1/incidents/{incidentId}/external-ids/{integrationId}': get: tags: - incidents summary: Get details associated with specific external system. description: Get details associated with a specific external system in the incident. Returns the systemName and all the details operationId: getIncidentExternalId parameters: - name: incidentId in: path description: incident ID required: true schema: type: integer format: int64 - name: integrationId in: path description: integration ID required: true schema: type: string minLength: 1 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseExternalSystemDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint patch: tags: - incidents summary: Update externalID information to an incident. description: Updates details about an external system to the incident operationId: patchIncidentExternalId parameters: - name: incidentId in: path description: incident ID required: true schema: type: integer format: int64 - name: integrationId in: path description: integration ID required: true schema: type: string pattern: \S requestBody: description: Configs used to update existing configs. required: true content: application/json: schema: $ref: '#/components/schemas/ExternalSystemDto' responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint delete: tags: - incidents summary: Delete externalID information from an incident. description: Delete details about an external system in the incident operationId: deleteIncidentExternalId parameters: - name: incidentId in: path description: incident ID required: true schema: type: integer format: int64 - name: integrationId in: path description: integration ID required: true schema: type: string minLength: 1 responses: '204': description: No Content '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint post: tags: - incidents summary: Add externalID information to an incident. description: Add details about an external system to the incident operationId: postIncidentExternalId parameters: - name: incidentId in: path description: incident ID required: true schema: type: integer format: int64 - name: integrationId in: path description: integration ID required: true schema: type: string pattern: \S requestBody: description: Configs used to update existing configs. required: true content: application/json: schema: $ref: '#/components/schemas/ExternalSystemDto' responses: '201': description: Created '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint /v1/incident-workflows/standalone: post: tags: - incident-workflows summary: Invokes the named standalone workflow on a single incident. description: Invokes the named standalone workflow on a single incident. operationId: invokeIncidentStandaloneWorkflow requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/StandaloneWorkflowInvocationRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseVoid' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint '/v1/incidents/{incidentId}/tags': patch: tags: - incidents summary: Update the incident with the given tags description: 'Update the incident ' operationId: updateIncidentTags parameters: - name: incidentId in: path description: Id of the incident being updated required: true schema: type: integer format: int64 requestBody: description: Tags to attach to the incident required: true content: application/json: schema: $ref: '#/components/schemas/SetIncidentTagsPayloadDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:edit' description: Required user permissions for this endpoint /v1/incident-filters/validate: post: tags: - incident-filters summary: Validate Incident Filter operationId: validateIncidentFilter requestBody: required: true content: application/json: schema: type: array minItems: 1 items: $ref: '#/components/schemas/IncidentFilterStrDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseIncidentFilterStrResultDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint /v1/alert-workflows/test: post: tags: - alert-workflows summary: Tests an alert workflow. description: Tests an alert workflow. operationId: testAlertWorkflow requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WorkflowTestWrapperDto' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfWorkflowTestResultDto' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'workflows:edit' description: Required user permissions for this endpoint '/v1/situation-room/{incidentId}/alerts': post: tags: - alerts summary: 'Get alerts for an incident, for the situation room' description: 'Get alerts for an incident, for the situation room' operationId: getSituationRoomAlerts parameters: - name: incidentId in: path required: true schema: type: integer format: int64 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SituationRoomAlertsRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseSituationRoomAlertList' '400': description: Bad Request '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'alerts:view' description: Required user permissions for this endpoint /v1/incident-workflows/inputs: get: tags: - incident-workflows summary: Returns inputs previously seen at the input of incident workflow engine. description: Returns inputs previously seen at the input of incident workflow engine. operationId: getRecentIncidents parameters: - name: entryFilter in: query schema: type: string description: Entry filter for the workflow (can be empty) - name: limit in: query schema: type: integer description: Maximum number of previously stored inputs to return format: int32 minimum: 1 default: 100 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfRecentInputDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: [] description: Required user permissions for this endpoint '/v1/situation-room/{incidentId}/timeline': get: tags: - incidents summary: Get timeline for an incident description: Get timeline for an incident operationId: getIncidentTimeline parameters: - name: incidentId in: path description: Incident Id required: true schema: type: integer format: int64 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MoogResponseListOfIncidentTimelineDto' '400': description: Invalid parameters or data validation violation content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' '404': description: Requested object(s) not found content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 4XX: description: Authorization or other error content: application/json: schema: $ref: '#/components/schemas/MoogFailureResponse' 5XX: description: Error content: application/json: schema: $ref: '#/components/schemas/MoogErrorResponse' security: - ApiKeyAuth: [] servers: - url: 'https://api.moogsoft.ai' - url: 'https://api.dev.moogsoft.cloud' x-permissions: value: - 'incidents:view' description: Required user permissions for this endpoint tags: - name: alert-filters description: Validate filters for alerts - name: alert-workflows description: Alert Workflow related endpoints - name: alerts description: Alerts generated by Moogsoft Cloud - name: alerts-search - name: autoclose-config description: Autoclose config for alerts and incidents - name: autoclose-policy description: Autoclose policy for alerts and incidents - name: automation-config description: Automation config for auto close of alerts and incidents - name: dashboardSummaryPost - name: event-columns description: Endpoints relating to getting event columns - name: events description: Endpoints related to event deduplication - name: incident columns resource description: Returns incident columns names and types - name: incident-comments description: 'Get, save and edit incident comments' - name: incident-filters description: Validate incident filters - name: incident-license-restrictions description: Incident based license restrictions - name: incident-tags-config description: Incident tags configuration - name: incident-workflows description: Incident Workflow endpoints - name: incidents description: CRUD operations for incidents - name: operationalStats - name: overviewStats externalDocs: url: 'https://docs.moogsoft.com/en/moogsoft-apis.html' description: Find out more about Apex AIOps Incident Management components: securitySchemes: ApiKeyAuth: type: apiKey description: API Key for accessing Alerts/Incidents API name: apiKey in: header schemas: MoogResponseColumnsDto: type: object description: Alerts/Incidents API ColumnsDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/ColumnsDto' required: - status - data ColumnsDto: type: object title: Columns Dto properties: fields: type: array items: $ref: '#/components/schemas/ColumnInfo' ColumnInfo: type: object title: Column Info properties: colId: type: string headerName: type: string cellRenderer: type: string sortable: type: boolean hide: type: boolean filterOptions: $ref: '#/components/schemas/FilterOptions' FilterOptions: type: object title: Filter Options properties: type: type: string operators: type: array items: $ref: '#/components/schemas/ComparisonType' setValues: type: array items: type: string category: $ref: '#/components/schemas/FieldCategory' ComparisonType: type: string enum: - equals - notEqual - contains - notContains - startsWith - endsWith - lessThan - lessThanOrEqual - greaterThan - greaterThanOrEqual - inRange - blank - notBlank - exactMatch - notExactMatch title: Comparison Type description: Comparison operator type to use for the filter FieldCategory: type: string enum: - primitive - array title: Field Category MoogFailureResponse: type: object description: Alerts/Incidents API failure response body properties: status: type: string description: Failure status indicator (always "failure") examples: - failure message: type: string additional: type: array items: type: string required: - status - message MoogErrorResponse: type: object description: Alerts/Incidents API error response body properties: status: type: string description: Error status indicator (always "error") examples: - error message: type: string additional: type: array items: type: string required: - status - message MoogResponseListOfAutoCloseConfigDto: type: object description: Alerts/Incidents API AutoCloseConfigDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/AutoCloseConfigDto' required: - status - data AutoCloseConfigDto: type: object title: Auto Close Config Dto properties: never_auto_close_enabled: type: boolean description: Indicates whether to use the provided Never Auto Close filters when auto-closing incidents or alerts never_auto_close_filters: type: array description: List of filters used to determine which incidents or alerts will never be auto-closed items: type: string close_alerts_when_all_incidents_closed: type: boolean description: 'When set to true, alerts will be automatically closed when all related incidents are closed. When set to false, alerts will be automatically closed when any related incident is closed.' id: type: string description: ID of the auto-close config type: type: string description: 'Type of auto-close config, either incident or alert' incidents_processed: type: integer description: Number of incidents processed by the configuration format: int32 alerts_processed: type: integer description: Number of alerts processed by the configuration format: int32 last_updated: $ref: '#/components/schemas/Instant' description: Time at which the configuration was last updated last_updated_by: type: string description: Email of the user who last updated the configuration Instant: type: number title: Instant format: int64 examples: - '2022-03-10T16:15:50Z' MoogResponseAutoCloseConfigDto: type: object description: Alerts/Incidents API AutoCloseConfigDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/AutoCloseConfigDto' required: - status - data MoogResponseListOfAutoClosePolicyDto: type: object description: Alerts/Incidents API AutoClosePolicyDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/AutoClosePolicyDto' required: - status - data AutoClosePolicyDto: type: object title: Auto Close Policy Dto properties: name: type: string type: type: string description: type: string filter: type: string close_resolved_in_seconds: type: integer format: int64 close_all_in_seconds: type: integer format: int64 id: type: string created_at: $ref: '#/components/schemas/Instant' created_by: type: string last_updated: $ref: '#/components/schemas/Instant' last_updated_by: type: string BaseAutoClosePolicyDto: type: object title: Base Auto Close Policy Dto properties: name: type: string type: type: string description: type: string filter: type: string close_resolved_in_seconds: type: integer format: int64 close_all_in_seconds: type: integer format: int64 MoogResponseAutoClosePolicyDto: type: object description: Alerts/Incidents API AutoClosePolicyDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/AutoClosePolicyDto' required: - status - data SituationRoomAlertsRequestV2: type: object title: Situation Room Alerts Request V2 description: Situation Room alerts POST request body. properties: filter: $ref: '#/components/schemas/QueryFilter' description: The filter type and object to retrieve data by start: type: integer description: 'The starting offset of alerts to retrieve. The initial offset to use is 0 and thereafter is typically multiples of ''limit''. NOTE: ''start'' + ''limit'' must not exceed 10,000 -- use ''searchAfter'' instead.' format: int32 minimum: 0 default: 0 limit: type: integer description: Maximum number of alerts to return. This is equivalent to the maximum number of alerts per page. Between 1 and 5000 format: int32 exclusiveMinimum: 0 maximum: 5000 default: 100 fields: type: array description: Subset of fields to return (default is all non-null alert fields examples: - [] items: type: string required: - filter QueryFilter: type: object title: Query Filter description: Types of inputs for the queryFilter. oneOf: - $ref: '#/components/schemas/SituationTextFilterDto' - $ref: '#/components/schemas/SituationJsonFilterDto' SituationTextFilterDto: type: object title: Situation Text Filter Dto properties: type: const: TEXT description: Declares text filter type filter_object: type: string sort_criteria: $ref: '#/components/schemas/SortCriteriaDto' required: - type SortCriteriaDto: type: object title: Sort Criteria Dto properties: sort_by: type: string sort_order: $ref: '#/components/schemas/SortOrder' SortOrder: type: string enum: - asc - desc title: Sort Order default: desc SituationJsonFilterDto: type: object title: Situation Json Filter Dto properties: type: const: JSON description: Declares json filter type filter_object: $ref: '#/components/schemas/ColumnFilterMap' description: Return only alerts that match this AG-Grid-style JSON filter (See ColumnFilter schema). sort_criteria: type: array description: Sort the results according to this AG-Grid-style JSON sort array. examples: - - sort: asc colId: severity - sort: desc colId: alert_id items: $ref: '#/components/schemas/AgGridSortColumn' required: - type AgGridSortColumn: type: object title: Ag Grid Sort Column description: Sorting criteria to use for searches properties: colId: type: string description: The column on which to sort minLength: 1 sort: type: string enum: - asc - desc description: The direction in which to sort pattern: asc|desc required: - colId - sort MoogResponseSituationRoomAlertList: type: object description: Alerts/Incidents API SituationRoomAlertList response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/SituationRoomAlertList' required: - status - data SituationRoomAlertList: type: object title: Situation Room Alert List properties: result: type: array items: $ref: '#/components/schemas/SituationRoomAlertDto' count: type: integer format: int64 SituationRoomAlertDto: type: object title: SituationRoomAlertDetails properties: status: $ref: '#/components/schemas/Status' description: alert/incident status severity: $ref: '#/components/schemas/Severity' description: alert/incident severity level severity_high_water: $ref: '#/components/schemas/Severity' description: alert/incident high-water severity level assignee: type: string description: email of the user who is assigned to the alert/incident examples: - test@moogsoft.com assigned_groups: type: array description: An array of group ids examples: - - goupid1 - groupid2 items: type: string first_event_time: type: integer description: Epoch timestamp in seconds of the first event for this alert/incident format: int64 examples: - 1607985505 last_event_time: type: integer description: Epoch timestamp in seconds of the last event for this alert/incident format: int64 examples: - 1607985505 description: type: string description: 'description that usually contains the alert/incident ID, source and service' examples: - | 1 Source: www.your-source.com Affected retail, support status_numeric: type: integer format: int32 severity_numeric: type: integer format: int32 severity_high_water_numeric: type: integer format: int32 alert_id: type: integer format: int64 class: type: string event_count: type: integer format: int32 manager_id: type: string location: type: object description: Mapping of location name/value pairs examples: - street: 1234 Battery St. city: San Francisco state: CA postcode: '95454' service: type: array items: type: string incidents: type: array items: type: integer format: int64 source: type: string in_maintenance: type: boolean description: Boolean indicating if the alert is currently in maintenance maintenance: type: string description: The id of the current or most recent maintenance window occurrence the alert was in maintenance_windows: type: array description: Set of all maintenance windows and occurrences the alert has been associated with uniqueItems: true items: $ref: '#/components/schemas/MaintenanceWindowStatDto' tags: type: object description: Mapping of tag name/value pairs examples: - key1: value1 key2: value2 namespace: type: string manager: type: string dedupe_key: type: string created_at: type: integer description: Epoch timestamp in seconds indicating when the alert was created format: int64 examples: - 1607985505 last_status_change_time: type: integer format: int64 alias: type: string check: type: string type: type: string policy: type: string external_details: type: array items: $ref: '#/components/schemas/ExternalSystemDto' external_names: type: array items: type: string root_cause: $ref: '#/components/schemas/AlertPrc' Status: type: string enum: - error - open - in progress - superseded - resolved - closed title: Status description: Status for incidents and alerts (case-insensitive) Severity: type: string enum: - clear - unknown - warning - minor - major - critical title: Severity description: Severity Level (case-insensitive) MaintenanceWindowStatDto: type: object title: Maintenance Window Stat Dto properties: window_id: type: string description: unique id of the maintenance window occurrence_id: type: string description: unique id of the maintenance window occurrence enter: type: integer description: Epoch timestamp in millis of when the alert entered maintenance format: int64 exit: type: integer description: Epoch timestamp in millis of when the alert left maintenance format: int64 ExternalSystemDto: type: object title: External System Dto properties: integration_id: type: string external_name: type: string external_id: type: string external_link: type: string integration_name: type: string integration_type: type: string AlertPrc: type: object title: SituationRoomAlertDetails properties: rc_probability: type: number description: 'The computed root cause probability, 0.0 - 1.0, if any' rc_label: $ref: '#/components/schemas/PrcLabel' description: 'The user-assigned label, if any' rc_bucket: $ref: '#/components/schemas/PrcBucket' description: 'The computed level: high, medium, low' PrcLabel: type: string enum: - RootCause - NonCausal - DontKnow title: Prc Label description: Root-Cause Label (case-insensitive) PrcBucket: type: string enum: - High - Medium - Low title: Prc Bucket description: Root-Cause Level (case-insensitive) MoogResponseOverviewWebResponse: type: object description: Alerts/Incidents API OverviewWebResponse response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/OverviewWebResponse' required: - status - data OverviewWebResponse: type: object title: Overview Web Response properties: incident_count: type: integer format: int64 alert_count: type: integer format: int64 event_count: type: integer format: int64 DashboardSummaryRequest: type: object title: Dashboard Summary Request description: Dashboard summary POST request body properties: json_filter: type: object description: Return only incidents that match this AG-Grid-style JSON filter. Each filter can be of a different filterType. additionalProperties: $ref: '#/components/schemas/ColumnFilter' examples: - status: values: - open - in progress - resolved filterType: set utc_offset: type: string description: The difference in hours from Coordinated Universal Time (UTC) to user's local time. default: GMT examples: - 'GMT-7/GMT+7:30' tile_by: type: string description: defines the grouping of alert/incident summary data pattern: services|classes|types|^tags\..* sort_by: $ref: '#/components/schemas/SortBy' description: defines the sorting of incident summary data required: - tile_by - sort_by ColumnFilter: type: object title: Column Filter description: 'Polymorphic column filter, based upon filterType' oneOf: - $ref: '#/components/schemas/DateColumnFilter' - $ref: '#/components/schemas/NumberColumnFilter' - $ref: '#/components/schemas/SetColumnFilter' - $ref: '#/components/schemas/TextColumnFilter' - $ref: '#/components/schemas/BooleanColumnFilter' discriminator: propertyName: filterType mapping: text: '#/components/schemas/TextColumnFilter' set: '#/components/schemas/SetColumnFilter' number: '#/components/schemas/NumberColumnFilter' date: '#/components/schemas/DateColumnFilter' boolean: '#/components/schemas/BooleanColumnFilter' DateColumnFilter: type: object title: Date Column Filter description: 'Filter a date-based column based on date or date ranges, and a comparison type
filterType = "date"' properties: type: $ref: '#/components/schemas/ComparisonType' description: Comparison operator dateFrom: type: string description: Date filter value to used with comparison operator dateTo: type: string description: Date filter value to used when comparison operator is inRange filterType: const: date description: Declares date filterType required: - type - filterType NumberColumnFilter: type: object title: Number Column Filter description: Filter a numeric column based on numeric value(s) and a comparison type
filterType = "number" properties: type: $ref: '#/components/schemas/ComparisonType' description: Comparison operator filter: type: integer description: Numeric filter value to used with comparison operator format: int64 filterTo: type: integer description: Numeric filter value to used when comparison operator is inRange format: int64 filterType: const: number description: Declares number filterType required: - type - filterType SetColumnFilter: type: object title: Set Column Filter description: Filter a column based on a set of values provided for comparison
filterType = "set" properties: type: $ref: '#/components/schemas/ComparisonType' description: Comparison operator values: type: array description: Set filter value(s) to used with comparison operator items: type: string filterType: const: set description: Declares set filterType required: - type - values - filterType TextColumnFilter: type: object title: Text Column Filter description: Filter a text column based on a string comparison
filterType = "text" properties: type: $ref: '#/components/schemas/ComparisonType' description: Comparison operator filter: type: string description: Text filter value to used with comparison operator filterType: const: text description: Declares text filterType required: - type - filterType BooleanColumnFilter: type: object title: Boolean Column Filter description: Filter a boolean column based on a boolean comparison
filterType = "boolean" properties: type: $ref: '#/components/schemas/ComparisonType' description: Comparison operator filter: type: boolean description: Boolean value to used for comparison filterType: const: boolean description: Declares boolean filterType required: - type - filter - filterType SortBy: type: string enum: - severity - priority title: Sort By description: Dashboard sort by options MoogResponseIncidentSummaryResponse: type: object description: Alerts/Incidents API IncidentSummaryResponse response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/IncidentSummaryResponse' required: - status - data IncidentSummaryResponse: type: object title: Incident Summary Response properties: tiles: type: array description: dashboard tile data items: $ref: '#/components/schemas/DashboardTile' incident_count: type: integer description: total incident count for summary view format: int64 alert_count: type: integer description: total alert count for summary view format: int64 event_count: type: integer description: total event count for summary view format: int64 open_incident_count: type: integer description: 'total of open, in progress and resolved incident count for summary view' format: int64 mttr: type: number description: mean time to resolve(in seconds) for incidents in summary view format: double mtta: type: number description: mean time to acknowledge(in seconds) for incidents in summary view format: double DashboardTile: type: object title: Dashboard Tile properties: name: type: string description: name of the tile open_count: type: integer description: number of "open + in progress + resolved" incidents format: int64 closed_count: type: integer description: number of closed incidents format: int64 severity_count: type: object description: this contains per severity counts additionalProperties: type: integer format: int64 examples: - '{critical: 10, major: 10}' priority_count: type: object description: this contains per priority counts additionalProperties: type: integer format: int64 examples: - '{P1: 10, P2: 10}' ResourceType: const: CATALOG title: Resource Type description: Representing different types of resources used by workflow action MoogResponseListOfWorkflowDependentOnResponseDto: type: object description: Alerts/Incidents API WorkflowDependentOnResponseDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/WorkflowDependentOnResponseDto' required: - status - data WorkflowDependentOnResponseDto: type: object title: Workflow Dependent On Response Dto description: Response DTO used to represent workflow that is dependent on resources properties: id: type: string description: ID of the workflow name: type: string description: Name of the workflow type: $ref: '#/components/schemas/WorkflowType' description: Type of the workflow WorkflowType: type: string enum: - EVENT - ALERT - INCIDENT - ALERT_STANDALONE - INCIDENT_STANDALONE title: Workflow Type MoogResponseExternalSystemDto: type: object description: Alerts/Incidents API ExternalSystemDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/ExternalSystemDto' required: - status - data BaseWorkflowDto: type: object title: Base Workflow Dto description: Base workflow attributes. properties: name: type: string description: Name of the workflow. This name cannot be empty and must be unique. description: type: string description: Optional description of the workflow. trigger: $ref: '#/components/schemas/WorkflowTriggerDto' description: Trigger of the workflow. type: $ref: '#/components/schemas/WorkflowType' description: Type of the workflow. priority: type: integer description: The priority of the workflow. format: int32 steps: type: array description: List of the configured workflow action(s). items: $ref: '#/components/schemas/WorkflowActionDto' required: - name - trigger - type - priority - steps WorkflowTriggerDto: type: object title: Workflow Trigger Dto description: The trigger definition for a workflow. properties: type: $ref: '#/components/schemas/WorkflowTriggerType' description: The workflow trigger type entryFilter: type: string description: Entry filter for the workflow (can be empty) required: - type WorkflowTriggerType: type: string enum: - EVENT_CREATED - ALERT_CREATED - ALERT_UPDATED - ALERT_DEDUPLICATED - INCIDENT_CREATED - INCIDENT_UPDATED - ALERT_CREATED_OR_UPDATED - ALERT_CREATED_OR_DEDUPLICATED - INCIDENT_CREATED_OR_UPDATED - ALERT_INVOKED - INCIDENT_INVOKED title: Workflow Trigger Type WorkflowActionDto: type: object title: Workflow Action Dto description: A configured action. properties: actionName: type: string description: Computer name of the action minLength: 1 maxLength: 127 description: type: string description: Description of the configured action configuration: type: object description: Configuration for the action error: type: string description: Error message associated with the configured action readOnly: true valid: type: boolean description: Indicates if the workflow action is valid readOnly: true required: - actionName - configuration AutomationConfigDto: type: object title: Automation Config Dto properties: closeAlertsWhenAllIncidentsClosed: type: boolean description: 'When set to true, alerts will be automatically closed when all related incidents are closed. When set to false, alerts will be automatically closed when any related incident is closed.' closeResolvedIncidentsInSeconds: type: integer description: Automatically close resolved incidents that have not been updated for XX seconds format: int64 closeResolvedAlertsInSeconds: type: integer description: Automatically close resolved alerts that have not been updated for XX seconds format: int64 closeIncidentsInSeconds: type: integer description: Automatically close any incidents that are older than XX seconds format: int64 closeAlertsInSeconds: type: integer description: Automatically close any alerts that are older than XX seconds format: int64 required: - closeAlertsWhenAllIncidentsClosed - closeResolvedIncidentsInSeconds - closeResolvedAlertsInSeconds - closeIncidentsInSeconds - closeAlertsInSeconds MoogResponseAutomationConfigDto: type: object description: Alerts/Incidents API AutomationConfigDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/AutomationConfigDto' required: - status - data MoogResponseIncidentCommentResponse: type: object description: Alerts/Incidents API IncidentCommentResponse response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/IncidentCommentResponse' required: - status - data IncidentCommentResponse: type: object title: Incident Comment Response properties: result: type: array items: $ref: '#/components/schemas/IncidentCommentDto' count: type: integer format: int64 resolving_step_count: type: integer format: int64 announcement_count: type: integer format: int64 resolvingStepCount: type: integer description: Use resolving_step_count instead format: int64 announcementCount: type: integer description: Use announcement_count instead format: int64 IncidentCommentDto: type: object title: Incident Comment Dto description: Comment details which are returned from comments endpoint properties: comment_id: type: string description: The unique comment ID of the comment examples: - 8b5ac7f4-b054-4d2f-9292-380618ecab11 incident_id: type: integer description: The unique incident ID of the incident where the comment belongs format: int64 examples: - 101 comment: type: string description: The comment's message examples: - This issue has been resolved user: $ref: '#/components/schemas/CommentUserDto' description: The comment owner's user details is_edited: type: boolean description: The flag indicates whether the comment is edited or not examples: - false type: $ref: '#/components/schemas/CommentType' description: 'The types of comment ''STANDARD'', ''RESOLVING'' & ''ANNOUNCEMENT''. The ''ANNOUNCEMENT'' type is immutable while the other types are interchangeable' created_at: $ref: '#/components/schemas/Instant' description: Epoch timestamp in seconds indicating when the comment was created commentId: type: string description: Use comment_id instead x-deprecated: true incidentId: type: integer description: Use incident_id instead format: int64 isEdited: type: boolean description: Use is_edited instead x-deprecated: true createdAt: $ref: '#/components/schemas/Instant' description: Use created_at instead CommentUserDto: type: object title: Comment User Dto properties: id: type: string family_name: type: string given_name: type: string email: type: string picture: type: string familyName: type: string description: Use family_name instead x-deprecated: true givenName: type: string description: Use given_name instead x-deprecated: true CommentType: type: string enum: - STANDARD - RESOLVING - ANNOUNCEMENT title: Comment Type description: CommentType for incidents comments CommentRequestDto: type: object title: Comment Request Dto description: Comment details which are needed to create a comment properties: comment: type: string description: The comment's message examples: - This issue has been resolved type: $ref: '#/components/schemas/CommentType' description: 'The types of comment ''STANDARD'', ''RESOLVING'' & ''ANNOUNCEMENT''. The ''ANNOUNCEMENT'' type is immutable while the other types are interchangeable' MoogResponseIncidentCommentDto: type: object description: Alerts/Incidents API IncidentCommentDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/IncidentCommentDto' required: - status - data BulkTestWorkflowDto: type: object title: Bulk Test Workflow Dto description: A bulk test workflow representing multiple workflows and test inputs. properties: triggerType: $ref: '#/components/schemas/WorkflowTriggerType' description: The workflow trigger type workflows: type: array description: The list of workflows to test with items: $ref: '#/components/schemas/WorkflowDto' inputs: type: array description: The list of inputs for the bulk workflow test items: type: object required: - triggerType - workflows - inputs WorkflowDto: type: object title: Workflow Dto description: Workflow with base and generated attributes. properties: name: type: string description: Name of the workflow. This name cannot be empty and must be unique. description: type: string description: Optional description of the workflow. trigger: $ref: '#/components/schemas/WorkflowTriggerDto' description: Trigger of the workflow. type: $ref: '#/components/schemas/WorkflowType' description: Type of the workflow. priority: type: integer description: The priority of the workflow. format: int32 steps: type: array description: List of the configured workflow action(s). items: $ref: '#/components/schemas/WorkflowActionDto' id: type: string description: ID of the workflow readOnly: true createdBy: type: string description: Creator of the workflow readOnly: true lastUpdatedBy: type: string description: Creator of the workflow readOnly: true status: $ref: '#/components/schemas/WorkflowStatus' description: Status of the workflow metrics: $ref: '#/components/schemas/WorkflowMetricsDto' description: Metrics about the running workflow test: $ref: '#/components/schemas/WorkflowTestResultDto' description: The last asynchronous test results for the workflow lastUpdated: $ref: '#/components/schemas/Instant' description: The last updated time in milliseconds created: $ref: '#/components/schemas/Instant' description: The created time in milliseconds valid: type: boolean description: Indicates if the workflow-actions are valid readOnly: true required: - name - trigger - type - priority - steps WorkflowStatus: type: string enum: - DELETED - NOT_RUNNING - RUNNING title: Workflow Status WorkflowMetricsDto: type: object title: Workflow Metrics Dto description: Metrics about a running workflow. properties: processed: type: integer description: Number processed format: int64 errors: type: integer description: Number processed with error format: int64 skipped: type: integer description: Number of events ignored format: int64 discarded: type: integer description: Number of events discarded format: int64 filterMetrics: $ref: '#/components/schemas/FilterMetricsDto' description: The metrics for the workflow filter actionMetricsMap: type: object description: Map of the action name to action metrics additionalProperties: $ref: '#/components/schemas/ActionMetricsDto' highWatermarkProcessingDurationMillis: type: integer description: The highest watermark for processing duration (0 indicates less then 1ms) format: int64 averageProcessingDurationMillis: type: integer description: The average processing duration (0 indicates less then 1ms) format: int64 lowWatermarkProcessingDurationMillis: type: integer description: The lowest watermark for processing duration (0 indicates less then 1ms) format: int64 lastException: type: string description: A description of the last exception that occurred any where in the workflow lastExceptionMillis: type: integer description: The time in millis when the exception occurred format: int64 generalError: type: string description: A general error that occurred outside of the workflow generalErrorMillis: type: integer description: The time in millis when the general error occurred format: int64 FilterMetricsDto: type: object title: Filter Metrics Dto description: Metrics about a running filter. properties: included: type: integer description: Number included in the workflow format: int64 excluded: type: integer description: Number excluded from the workflow format: int64 errors: type: integer description: Number processed with error format: int64 processed: type: integer description: Number processed format: int64 highWatermarkProcessingDurationMillis: type: integer description: The highest watermark for processing duration (0 indicates less then 1ms) format: int64 averageProcessingDurationMillis: type: integer description: The average processing duration (0 indicates less then 1ms) format: int64 lowWatermarkProcessingDurationMillis: type: integer description: The lowest watermark for processing duration (0 indicates less then 1ms) format: int64 ActionMetricsDto: type: object title: Action Metrics Dto description: Metrics about a running action. properties: actionName: type: string description: The computer name for the action processed: type: integer description: Number processed format: int64 errors: type: integer description: Number processed with error format: int64 highWatermarkProcessingDurationMillis: type: integer description: The highest watermark for processing duration (0 indicates less then 1ms) format: int64 averageProcessingDurationMillis: type: integer description: The average processing duration (0 indicates less then 1ms) format: int64 lowWatermarkProcessingDurationMillis: type: integer description: The lowest watermark for processing duration (0 indicates less then 1ms) format: int64 skipped: type: integer description: Number of events skipped format: int64 discarded: type: integer description: Number of events discarded format: int64 WorkflowTestResultDto: type: object title: Workflow Test Result Dto description: Test results for a workflow. properties: status: $ref: '#/components/schemas/WorkflowTestStatus' description: Status of the test input: type: object description: Input for the workflow test output: type: object description: Output of the workflow test startMillis: type: integer description: Start time in millis of the workflow test format: int64 endMillis: type: integer description: End time in millis of the workflow test format: int64 filterTest: $ref: '#/components/schemas/FilterTestDto' description: Test results for the filter actionsTestList: type: array description: List of test results for each action items: $ref: '#/components/schemas/ActionTestDto' exception: type: string description: Description of any exceptions that occurred generalError: type: string description: Description of any error that occurred outside of the workflow skipped: type: boolean description: Input was skipped by one of the workflow actions discarded: type: boolean description: Input was discarded by one of the workflow actions WorkflowTestStatus: type: string enum: - RUNNING - FAILED - SUCCESS title: Workflow Test Status FilterTestDto: type: object title: Filter Test Dto description: Test results for a filter. properties: input: type: object description: Input for the filter startMillis: type: integer description: Start time in millis of the filter format: int64 endMillis: type: integer description: End time in millis of the filter format: int64 result: type: boolean description: Boolean result of running the filter exception: type: string description: Description of any exceptions that occurred ActionTestDto: type: object title: Action Test Dto description: Test results for an action. properties: actionName: type: string description: The computer name of the action input: type: object description: Input for the action output: type: object description: Output from the action startMillis: type: integer description: Start time in millis of the workflow action format: int64 endMillis: type: integer description: End time in millis of the workflow action format: int64 exception: type: string description: Description of any exceptions that occurred skipped: type: boolean description: Input was skipped by the workflow action discarded: type: boolean description: Input was discarded by the workflow action outputViolations: type: array description: Validation error messages generated while validating the action output items: type: string MoogResponseListOfBulkTestWorkflowResultsDto: type: object description: Alerts/Incidents API BulkTestWorkflowResultsDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/BulkTestWorkflowResultsDto' required: - status - data BulkTestWorkflowResultsDto: type: object title: Bulk Test Workflow Results Dto description: A bulk test workflow results. properties: input: type: object description: Original input provided to the workflows under test workflows: type: array description: Workflow status and test results for each workflow tested items: $ref: '#/components/schemas/WorkflowDto' PatchPayloadDto: type: object title: Patch Payload Dto description: Incident update payload properties: status: $ref: '#/components/schemas/Status' description: status that gets assigned to the incident assignee: type: string description: user email that gets assigned to the incident examples: - exampleUser@moogsoft.com assigned_groups: type: array description: 'An array of group ids or group names, returns error if any of them not found' examples: - - goupid1 - groupid2 items: type: string description: type: - string - 'null' description: Allows for overriding calculated description with a manual one. Restore calculated behavior by setting to an empty string. maxLength: 32500 examples: - New description text priority: $ref: '#/components/schemas/Priority' impact: $ref: '#/components/schemas/Impact' urgency: $ref: '#/components/schemas/Urgency' Priority: type: string enum: - P1 - P2 - P3 - P4 - P5 title: Priority description: Priority of an incident Impact: type: string enum: - high - medium - low title: Impact description: Impact of an incident Urgency: type: string enum: - high - medium - low title: Urgency description: Urgency of an incident MoogResponseIncidentDto: type: object description: Alerts/Incidents API IncidentDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/IncidentDto' required: - status - data IncidentDto: type: object title: Incident Dto description: Incidents returned from list endpoint properties: status: $ref: '#/components/schemas/Status' description: alert/incident status severity: $ref: '#/components/schemas/Severity' description: alert/incident severity level severity_high_water: $ref: '#/components/schemas/Severity' description: alert/incident high-water severity level assignee: type: string description: email of the user who is assigned to the alert/incident examples: - test@moogsoft.com assigned_groups: type: array description: An array of group ids examples: - - goupid1 - groupid2 items: type: string first_event_time: type: integer description: Epoch timestamp in seconds of the first event for this alert/incident format: int64 examples: - 1607985505 last_event_time: type: integer description: Epoch timestamp in seconds of the last event for this alert/incident format: int64 examples: - 1607985505 description: type: string description: 'description that usually contains the alert/incident ID, source and service' examples: - | 1 Source: www.your-source.com Affected retail, support status_numeric: type: integer format: int32 severity_numeric: type: integer format: int32 severity_high_water_numeric: type: integer format: int32 incident_id: type: integer description: incident ID format: int64 examples: - 101 closed_on: type: integer description: Epoch timestamp in seconds indicating when the incident was closed format: int64 examples: - 1607985505 created_at: type: integer description: Epoch timestamp in seconds indicating when the incident was created format: int64 examples: - 1607985505 classes: type: array description: incident classes items: type: string services: type: array description: incident services items: type: string in_progress_on: type: integer description: Epoch timestamp in seconds indicating when the incident was moved to in progress format: int64 examples: - 1607985505 last_state_change: type: integer description: Epoch timestamp in seconds indicating when the incident status was changed format: int64 examples: - 1607985505 resolved_on: type: integer description: Epoch timestamp in seconds indicating when the incident was resolved format: int64 examples: - 1607985505 superseded_on: type: integer description: Epoch timestamp in seconds indicating when the incident was superseded format: int64 examples: - 1607985505 superseded_by: type: integer description: the superseded by incident ID format: int64 examples: - 33 merged_into_incident: type: integer description: the ID of the incident that this incident was merged into format: int64 examples: - 33 correlation_definition: type: string description: correlation definition uuid used to create the incident examples: - a551ab9f-c5ab-4dfe-a52d-b325393176af source_correlation_name: type: string description: correlation definition name used to create the incident examples: - Similar Sources tags: type: object description: the tags belong to the incident additionalProperties: type: array items: type: string types: type: array description: the unique types belong to the incident items: type: string policies: type: array description: the unique policies belong to the incident items: type: string alerts: type: array items: type: integer format: int64 maintenance_windows: type: array description: Set of all maintenance windows and occurrences the incident has been associated with items: $ref: '#/components/schemas/MaintenanceWindowStatDto' auto_closed_on: type: integer format: int64 priority: $ref: '#/components/schemas/Priority' impact: $ref: '#/components/schemas/Impact' urgency: $ref: '#/components/schemas/Urgency' external_details: type: array items: $ref: '#/components/schemas/ExternalSystemDto' comments: type: array items: $ref: '#/components/schemas/CommentDto' sources: type: array description: incident sources items: type: string total_alerts: type: integer description: the total alerts belong to the incident format: int64 examples: - 30 external_names: type: array items: type: string in_maintenance: type: boolean manual_description_set: type: boolean priority_numeric: type: integer format: int32 resolving_steps: type: integer description: the total number of resolving steps format: int64 examples: - 30 resolve_time: type: integer description: 'Time taken to resolve, resolved or closed incidents (in seconds).' format: int64 CommentDto: type: object title: Comment Dto properties: id: type: string comment: type: string created_by: type: string created_at: type: integer format: int64 is_resolving_step: type: boolean writeOnly: true type: $ref: '#/components/schemas/CommentType' is_edited: type: boolean MoogResponseListOfEventTimelineBucket: type: object description: Alerts/Incidents API EventTimelineBucket response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/EventTimelineBucket' required: - status - data EventTimelineBucket: type: object title: Event Timeline Bucket properties: start_time: type: integer description: Bucket start time in epoch timestamp in milliseconds format: int64 examples: - 1720083965000 end_time: type: integer description: Bucket end time in epoch timestamp in milliseconds format: int64 examples: - 1720084565000 severity_count: type: object description: Bucket severity count additionalProperties: type: integer format: int32 examples: - critical: 5 major: 2 minor: 3 OperationalStatsRequest: type: object title: Operational Stats Request description: Executive summary request body properties: start: type: integer description: Epoch timestamp(in milliseconds) used to filter out the results based on created at format: int64 exclusiveMinimum: 0 end: type: integer description: Epoch timestamp(in milliseconds) used to filter out the results till this time format: int64 exclusiveMinimum: 0 bucket_size: $ref: '#/components/schemas/HistogramInterval' description: Bucket size is used to fetch incident trend results per hour/day utc_offset: type: string description: The difference in hours from Coordinated Universal Time (UTC) to user's local time use for incident trend results default: GMT examples: - 'GMT-7/GMT+7:30' resource: $ref: '#/components/schemas/TopResourcesType' description: resource type to fetch required: - start - end - bucket_size HistogramInterval: type: string enum: - hour - day title: Histogram Interval description: Histogram calendar interval TopResourcesType: type: string enum: - services - sources title: Top Resources Type description: Top Resources Type to fetch MoogResponseOperationalStatsWebResponse: type: object description: Alerts/Incidents API OperationalStatsWebResponse response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/OperationalStatsWebResponse' required: - status - data OperationalStatsWebResponse: type: object title: Operational Stats Web Response description: Incident Operational stats response properties: time_to_resolve: $ref: '#/components/schemas/TimeToResolveDto' description: Time to resolve aggregated result of incidents incident_trend: type: array description: Incident trend list by severity items: $ref: '#/components/schemas/IncidentTrendDto' top_resources: type: array description: Incident top 20 resources list items: $ref: '#/components/schemas/IncidentTopResourcesDto' TimeToResolveDto: type: object title: Time To Resolve Dto description: Incidents resolution details properties: mttr_mins: type: number description: mean time to resolution(in minutes) format: double buckets: type: array description: List of time to resolve aggregated results items: $ref: '#/components/schemas/TimeToResolveBucketDto' TimeToResolveBucketDto: type: object title: Time To Resolve Bucket Dto properties: index: type: integer description: Time taken to resolve incident in hours range format: int64 examples: - '0, 2, 5 where 0 means incidents resolved in 0 to 1hr, 5 means 5 to 6hr' incident_count: type: integer description: Total incidents resolved format: int64 IncidentTrendDto: type: object title: Incident Trend Dto description: Incident trend data for the provided time period properties: incident_time: type: integer description: Incident creation time format: int64 incident_severity: type: object description: Incident counts by severity additionalProperties: type: integer format: int64 IncidentTopResourcesDto: type: object title: Incident Top Resources Dto description: Incident top resources for the provided time period properties: resource: type: string description: Incident resource name incident_count: type: integer description: Total incident count against the resource format: int64 incident_severity: type: object description: Incident counts by severity additionalProperties: type: integer format: int64 MoogResponseAlertDto: type: object description: Alerts/Incidents API AlertDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/AlertDto' required: - status - data AlertDto: type: object title: AlertDetails properties: status: $ref: '#/components/schemas/Status' description: alert/incident status severity: $ref: '#/components/schemas/Severity' description: alert/incident severity level severity_high_water: $ref: '#/components/schemas/Severity' description: alert/incident high-water severity level assignee: type: string description: email of the user who is assigned to the alert/incident examples: - test@moogsoft.com assigned_groups: type: array description: An array of group ids examples: - - goupid1 - groupid2 items: type: string first_event_time: type: integer description: Epoch timestamp in seconds of the first event for this alert/incident format: int64 examples: - 1607985505 last_event_time: type: integer description: Epoch timestamp in seconds of the last event for this alert/incident format: int64 examples: - 1607985505 description: type: string description: 'description that usually contains the alert/incident ID, source and service' examples: - | 1 Source: www.your-source.com Affected retail, support status_numeric: type: integer format: int32 severity_numeric: type: integer format: int32 severity_high_water_numeric: type: integer format: int32 alert_id: type: integer format: int64 class: type: string event_count: type: integer format: int32 manager_id: type: string location: type: object description: Mapping of location name/value pairs examples: - street: 1234 Battery St. city: San Francisco state: CA postcode: '95454' service: type: array items: type: string incidents: type: array items: type: integer format: int64 source: type: string in_maintenance: type: boolean description: Boolean indicating if the alert is currently in maintenance maintenance: type: string description: The id of the current or most recent maintenance window occurrence the alert was in maintenance_windows: type: array description: Set of all maintenance windows and occurrences the alert has been associated with uniqueItems: true items: $ref: '#/components/schemas/MaintenanceWindowStatDto' tags: type: object description: Mapping of tag name/value pairs examples: - key1: value1 key2: value2 namespace: type: string manager: type: string dedupe_key: type: string created_at: type: integer description: Epoch timestamp in seconds indicating when the alert was created format: int64 examples: - 1607985505 last_status_change_time: type: integer format: int64 alias: type: string check: type: string type: type: string policy: type: string external_details: type: array items: $ref: '#/components/schemas/ExternalSystemDto' external_names: type: array items: type: string BulkPatchPayloadDto: type: object title: Bulk Patch Payload Dto description: Incident bulk update payload properties: status: $ref: '#/components/schemas/Status' description: status that gets assigned to the incident assignee: type: string description: user email that gets assigned to the incident examples: - exampleUser@moogsoft.com assigned_groups: type: array description: 'An array of group ids or group names, returns error if any of them not found' examples: - - goupid1 - groupid2 items: type: string description: type: - string - 'null' description: Allows for overriding calculated description with a manual one. Restore calculated behavior by setting to an empty string. maxLength: 32500 examples: - New description text priority: $ref: '#/components/schemas/Priority' impact: $ref: '#/components/schemas/Impact' urgency: $ref: '#/components/schemas/Urgency' ids: type: array description: Unique incident ids to update minItems: 1 uniqueItems: true items: type: integer format: int64 required: - ids MoogResponseListOfIncidentDto: type: object description: Alerts/Incidents API IncidentDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/IncidentDto' required: - status - data MoogResponseIncidentList: type: object description: Alerts/Incidents API IncidentList response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/IncidentList' required: - status - data IncidentList: type: object title: Incident List properties: result: type: array items: $ref: '#/components/schemas/IncidentDto' count: type: integer format: int64 search_after: type: array description: 'When needing to scroll through a large number of incidents, the value of this field can be provided to the ''searchAfter'' parameter of the next query invocation.' ListIncidentsRequest: type: object title: List Incidents Request description: List incidents POST request body properties: start: type: integer description: 'Number of incidents to skip. That is, the first incident returned will be object # start + 1.' format: int32 minimum: 0 default: 0 examples: - 0 limit: type: integer description: 'Number of incidents to fetch, after skipping the number specified in the ''start'' parameter if any. Between 1 and 5000' format: int32 exclusiveMinimum: 0 maximum: 5000 default: 100 examples: - 100 json_filter: type: object description: Return only incidents that match this AG-Grid-style JSON filter. Each filter can be of a different filterType. additionalProperties: $ref: '#/components/schemas/ColumnFilter' examples: - status: values: - open - in progress - resolved filterType: set json_sort: type: array description: Sort the results according to this AG-Grid-style JSON sort info. examples: - - sort: asc colId: severity items: $ref: '#/components/schemas/AgGridSortColumn' keyword: type: string description: Return only incidents that contain these keywords. examples: - support utc_offset: type: string description: The difference in hours from Coordinated Universal Time (UTC) to user's local time. default: GMT examples: - 'GMT-7/GMT+7:30' search_after: type: array description: 'When needing to scroll through a large number of incidents, this parameter can be used instead of ''start'' to proceed with incidents that follow the previous search result. The ''searchAfter'' from the previous response must be provided along with the same filter and sort criteria. All results are exhausted when a search response includes no more incidents.' fields: type: array description: Subset of fields to return (default is all non-null incident fields items: type: string WorkflowTestWrapperDto: type: object title: Workflow Test Wrapper Dto description: A test workflow representing a workflow and test input. properties: name: type: string description: Name of the workflow. This name cannot be empty and must be unique. description: type: string description: Optional description of the workflow. trigger: $ref: '#/components/schemas/WorkflowTriggerDto' description: Trigger of the workflow. type: $ref: '#/components/schemas/WorkflowType' description: Type of the workflow. priority: type: integer description: The priority of the workflow. format: int32 steps: type: array description: List of the configured workflow action(s). items: $ref: '#/components/schemas/WorkflowActionDto' id: type: string description: ID of the workflow if it has already been saved input: type: array description: The input or list of inputs for the workflow test minItems: 1 items: type: object required: - name - trigger - type - priority - steps - input MoogResponseListOfWorkflowTestResultDto: type: object description: Alerts/Incidents API WorkflowTestResultDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/WorkflowTestResultDto' required: - status - data StandaloneWorkflowInvocationRequest: type: object title: Standalone Workflow Invocation Request description: Request for invoking a standalone workflow properties: workflow_id: type: string description: The id of the workflow to invoke. workflow_context: type: object description: Additional workflow context information. ids: type: array description: The ids of the workflow target. minItems: 1 items: type: integer format: int64 required: - workflow_id - workflow_context - ids MoogResponseVoid: type: object description: Empty (no data) response properties: status: type: string description: Success status indicator (always "success") examples: - success required: - status AlertUpdateRequest: type: object title: Alert Update Request properties: status: $ref: '#/components/schemas/Status' assignee: type: string description: 'Username of the assignee, specified as one string. Returns an error if the username is not found.' examples: - john.doe@company.com assigned_groups: type: array description: 'An array of group ids or group names, returns error if any of them not found' examples: - - groupid1 - groupid2 uniqueItems: true items: type: string MoogResponseListOfRecentInputDto: type: object description: Alerts/Incidents API RecentInputDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/RecentInputDto' required: - status - data RecentInputDto: type: object title: Recent Input Dto description: Previously stored sample of input data properties: id: type: string description: The unique id of the input data type: type: string description: The workflow type data: type: object description: The raw data itself FilterStringDto: type: object title: Filter String Dto description: A filter string to validate properties: filterString: type: string description: The filter string to validate pattern: \S examples: - severity = Clear AND source = www.my-source.com required: - filterString MoogResponseFilterStringResultDto: type: object description: Alerts/Incidents API FilterStringResultDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/FilterStringResultDto' required: - status - data FilterStringResultDto: type: object title: Filter String Result Dto description: The result of validating a filter string properties: isValid: type: boolean IncidentTagsConfigDto: type: object title: Incident Tags Config Dto properties: tags_propagation: type: boolean description: Flag to enable/disable incident tags propagation tags: type: array description: List of flags to propagate. NULL will propagate all. Empty will propagate none. items: type: string tagsPropagation: type: boolean description: Use tags_propagation instead x-deprecated: true required: - tags_propagation MoogResponseIncidentTagsConfigDto: type: object description: Alerts/Incidents API IncidentTagsConfigDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/IncidentTagsConfigDto' required: - status - data SetAlertTagsPayloadDto: type: object title: Set Alert Tags Payload Dto properties: tags: type: object description: The tags being added to the alert. additionalProperties: type: string required: - tags MoogResponseEventList: type: object description: Alerts/Incidents API EventList response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/EventList' required: - status - data EventList: type: object title: Event List properties: total_results: type: integer format: int32 results: type: array items: $ref: '#/components/schemas/EventTimelineDto' EventTimelineDto: type: object title: Event Timeline Dto properties: event_id: type: string source: type: string check: type: string severity: $ref: '#/components/schemas/Severity' description: type: string dedupe_key: type: string time: type: integer format: int64 services: type: array items: type: string alias: type: string utc_offset: type: string manager: type: string manager_id: type: string class: type: string namespace: type: string maintenance: type: string type: type: string tags: type: object location: $ref: '#/components/schemas/LocationDto' policy: type: string additional_info: type: object sequence_id: type: integer format: int32 required: - source - check - severity - description LocationDto: type: object title: Location properties: street: type: string building: type: string suite: type: integer format: int32 floor: type: string city: type: string state_or_province: type: string country: type: string postcode: type: string geo_coordinates: $ref: '#/components/schemas/GeoLocationDto' rack: type: string aisle: type: string u_position: type: string region: type: string data_center: type: string availability_zone: type: string geo_coordinates_lat: type: integer format: int32 geo_coordinates_long: type: integer format: int32 GeoLocationDto: type: object title: GeoLocation properties: lat: type: number format: float long: type: number format: float MoogResponseListOfExternalSystemDto: type: object description: Alerts/Incidents API ExternalSystemDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/ExternalSystemDto' required: - status - data ListSnapshotRequest: type: object title: List Snapshot Request description: List alert snapshot POST request body. properties: ids: type: array description: Unique alert IDs for which to retrieve earliest/highest severity snapshot minItems: 1 examples: - - 12 - 29 items: type: integer format: int64 fields: type: array description: Subset of fields to return (default is all non-null alert fields) items: type: string required: - ids MoogResponseAlertList: type: object description: Alerts/Incidents API AlertList response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/AlertList' required: - status - data AlertList: type: object title: Alert List properties: result: type: array items: $ref: '#/components/schemas/AlertDto' count: type: integer format: int64 search_after: type: array description: 'When needing to scroll through a large number of alerts, the value of this field can be provided to the ''searchAfter'' parameter of the next query invocation.' searchAfter: type: array description: Use search_after instead readOnly: true x-deprecated: true UnlabeledRequestDto: type: object title: Unlabeled Request Dto properties: incident_ids: type: array description: Set of unique incident IDs which are to be queried minItems: 1 uniqueItems: true items: type: integer format: int64 required: - incident_ids MoogResponseUnlabeledResponseDto: type: object description: Alerts/Incidents API UnlabeledResponseDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/UnlabeledResponseDto' required: - status - data UnlabeledResponseDto: type: object title: Unlabeled Response Dto properties: total_incidents: type: integer format: int64 total_alerts: type: integer format: int64 unlabeled_counts: type: object additionalProperties: type: integer format: int64 BulkAlertUpdateRequest: type: object title: Bulk Alert Update Request properties: status: $ref: '#/components/schemas/Status' assignee: type: string description: 'Username of the assignee, specified as one string. Returns an error if the username is not found.' examples: - john.doe@company.com assigned_groups: type: array description: 'An array of group ids or group names, returns error if any of them not found' examples: - - groupid1 - groupid2 uniqueItems: true items: type: string ids: type: array description: Unique alert ids to update minItems: 1 examples: - - 12 - 29 uniqueItems: true items: type: integer format: int64 required: - ids MoogResponseListOfAlertDto: type: object description: Alerts/Incidents API AlertDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/AlertDto' required: - status - data ListAlertsRequest: type: object title: List Alerts Request description: List alerts POST request body. properties: filter: type: string description: Return only alerts that match this filter.
Returns **400 (Invalid parameters)** if the filter format is invalid. examples: - '''event count'' > 3 AND severity in (Critical, Major, Minor, Warning)' json_filter: type: object description: Return only alerts that match this AG-Grid-style JSON filter. Each filter can be of a different filterType. additionalProperties: $ref: '#/components/schemas/ColumnFilter' examples: - status: values: - open - in progress - resolved filterType: set json_sort: type: array description: Sort the results according to this AG-Grid-style JSON sort array. examples: - - sort: asc colId: severity - sort: desc colId: alert_id items: $ref: '#/components/schemas/AgGridSortColumn' keyword: type: string description: Return only alerts that contain these keywords. utc_offset: type: string description: UTC Offset default: GMT-0 start: type: integer description: 'The starting offset of alerts to retrieve. The initial offset to use is 0 and thereafter is typically multiples of ''limit''. NOTE: ''start'' + ''limit'' must not exceed 10,000 -- use ''searchAfter'' instead.' format: int32 minimum: 0 default: 0 limit: type: integer description: Maximum number of alerts to return. This is equivalent to the maximum number of alerts per page. Between 1 and 5000 format: int32 exclusiveMinimum: 0 maximum: 5000 default: 100 sort_by: type: string description: Field to sort by sort_order: $ref: '#/components/schemas/SortOrder' description: Sort order search_after: type: array description: 'When needing to scroll through a large number of alerts, this parameter can be used instead of ''start'' to proceed with alerts that follow the previous search result. The ''searchAfter'' from the previous response must be provided along with the same filter and sort criteria. All results are exhausted when a search response includes no more alerts.' fields: type: array description: Subset of fields to return (default is all non-null alert fields items: type: string SetIncidentTagsPayloadDto: type: object title: Set Incident Tags Payload Dto properties: tags: type: object description: The tags being added to the incident additionalProperties: type: array items: type: string required: - tags IncidentFilterStrDto: type: object title: Incident Filter Str Dto description: An incident's filter string to validate properties: filterString: type: string description: The incident's filter string to validate pattern: \S examples: - severity = Clear AND source = www.my-source.com required: - filterString MoogResponseIncidentFilterStrResultDto: type: object description: Alerts/Incidents API IncidentFilterStrResultDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: $ref: '#/components/schemas/IncidentFilterStrResultDto' required: - status - data IncidentFilterStrResultDto: type: object title: Incident Filter Str Result Dto description: The result of validating an incident's filter string properties: isValid: type: boolean SituationRoomAlertsRequest: type: object title: Situation Room Alerts Request description: Situation Room alerts POST request body. properties: json_filter: type: object description: Return only alerts that match this AG-Grid-style JSON filter. Each filter can be of a different filterType. additionalProperties: $ref: '#/components/schemas/ColumnFilter' examples: - status: values: - open - in progress - resolved filterType: set json_sort: type: array description: Sort the results according to this AG-Grid-style JSON sort array. examples: - - sort: asc colId: severity - sort: desc colId: alert_id items: $ref: '#/components/schemas/AgGridSortColumn' start: type: integer description: 'The starting offset of alerts to retrieve. The initial offset to use is 0 and thereafter is typically multiples of ''limit''. NOTE: ''start'' + ''limit'' must not exceed 10,000 -- use ''searchAfter'' instead.' format: int32 minimum: 0 default: 0 limit: type: integer description: Maximum number of alerts to return. This is equivalent to the maximum number of alerts per page. Between 1 and 5000 format: int32 exclusiveMinimum: 0 maximum: 5000 default: 100 fields: type: array description: Subset of fields to return (default is all non-null alert fields items: type: string MoogResponseListOfIncidentTimelineDto: type: object description: Alerts/Incidents API IncidentTimelineDto response body properties: status: type: string description: Success status indicator (always "success") examples: - success data: type: array items: $ref: '#/components/schemas/IncidentTimelineDto' required: - status - data IncidentTimelineDto: type: object title: Incident Timeline Dto description: Incident timeline entry details properties: summary_title: type: string description: The activity title examples: - First Event summary_subtitle: type: string description: The activity subtitle examples: - Alert 4 activity_type: $ref: '#/components/schemas/ActivityType' description: The timeline entry activity type severity: type: string description: The severity of the alert. Used only for alerts activity examples: - MINOR redirection_id: type: string description: The ID which can be used to redirect examples: - '4' description: type: string description: The activity description examples: - Assigned groups changed to Cloud Team activity_time: type: integer description: Epoch timestamp in milliseconds indicating when the activity happened format: int64 examples: - 1681968617138 correlation_definition: type: object description: The correlation definition for incident/alert related activities notification_sent: type: object description: An on-call notification sent for this incident manual_description_set: type: boolean description: Indicates an incident description was created manually examples: - true comment_type: $ref: '#/components/schemas/CommentType' description: The type of comment. Used only for comments activity user: $ref: '#/components/schemas/TimelineUserDto' description: The user that performed the activity action_by: type: string description: The user mail id that performed the activity reference_alert_id: type: integer description: The ID other alerts were referenced against format: int64 examples: - 4 fields: type: string description: The fields and values from the correlation definition associated with the reference alert summaryTitle: type: string description: Use summary_title instead x-deprecated: true summarySubtitle: type: string description: Use summary_subtitle instead x-deprecated: true activityType: $ref: '#/components/schemas/ActivityType' description: Use activity_type instead redirectionId: type: string description: Use redirection_id instead x-deprecated: true activityTime: type: integer description: Use activity_time instead format: int64 correlationDefinition: type: object description: Use correlation_definition instead x-deprecated: true manualDescriptionSet: type: boolean description: Use manual_description_set instead x-deprecated: true ActivityType: type: string enum: - FIRST_EVENT - INCIDENT_CREATED - ALERT_ADDED - ALERT_STATUS_CHANGE - ALERT_ASSIGNMENT - INCIDENT_STATUS_CHANGE - INCIDENT_ASSIGNMENT - COMMENT_ADDED - COMMENT_EDITED - DESCRIPTION_CHANGE - INCIDENT_GROUP_ASSIGNMENT - ALERT_GROUP_ASSIGNMENT - ANNOUNCEMENT - WATCHER_ADDED - WATCHER_REMOVED title: Activity Type description: Activity type for incident timeline TimelineUserDto: type: object title: Timeline User Dto properties: id: type: string family_name: type: string given_name: type: string email: type: string picture: type: string familyName: type: string description: Use family_name instead x-deprecated: true givenName: type: string description: Use given_name instead x-deprecated: true security: - ApiKeyAuth: []