Keep alerts API
The alerts API from Keep — 24 operation(s) for alerts.
The alerts API from Keep — 24 operation(s) for alerts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/keep-alerts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Keep actions Alerts API
description: Rest API powering https://platform.keephq.dev and friends 🏄♀️
version: 0.24.5
servers:
- url: https://api.keephq.dev
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: alerts
paths:
/alerts:
get:
tags:
- alerts
summary: Get All Alerts
description: Get last alerts occurrence
operationId: get_all_alerts_alerts_get
parameters:
- required: false
schema:
type: integer
title: Limit
default: 1000
name: limit
in: query
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/AlertDto'
type: array
title: Response Get All Alerts Alerts Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
delete:
tags:
- alerts
summary: Delete Alert
description: Delete alert by finerprint and last received time
operationId: delete_alert_alerts_delete
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteRequestBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties:
type: string
type: object
title: Response Delete Alert Alerts Delete
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/{fingerprint}/history:
get:
tags:
- alerts
summary: Get Alert History
description: Get alert history
operationId: get_alert_history_alerts__fingerprint__history_get
parameters:
- required: true
schema:
type: string
title: Fingerprint
name: fingerprint
in: path
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/AlertDto'
type: array
title: Response Get Alert History Alerts Fingerprint History Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/{fingerprint}/assign/{last_received}:
post:
tags:
- alerts
summary: Assign Alert
description: Assign alert to user
operationId: assign_alert_alerts__fingerprint__assign__last_received__post
parameters:
- required: true
schema:
type: string
title: Fingerprint
name: fingerprint
in: path
- required: true
schema:
type: string
title: Last Received
name: last_received
in: path
- required: false
schema:
type: boolean
title: Unassign
default: false
name: unassign
in: query
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties:
type: string
type: object
title: Response Assign Alert Alerts Fingerprint Assign Last Received Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/event:
post:
tags:
- alerts
summary: Receive Generic Event
description: Receive a generic alert event
operationId: receive_generic_event_alerts_event_post
parameters:
- required: false
schema:
type: string
title: Fingerprint
name: fingerprint
in: query
requestBody:
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/AlertDto'
- items:
$ref: '#/components/schemas/AlertDto'
type: array
- type: object
title: Event
required: true
responses:
'202':
description: Successful Response
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/AlertDto'
- items:
$ref: '#/components/schemas/AlertDto'
type: array
title: Response Receive Generic Event Alerts Event Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/event/netdata:
get:
tags:
- alerts
summary: Webhook Challenge
description: Helper function to complete Netdata webhook challenge
operationId: webhook_challenge_alerts_event_netdata_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/alerts/event/{provider_type}:
post:
tags:
- alerts
summary: Receive Event
description: Receive an alert event from a provider
operationId: receive_event_alerts_event__provider_type__post
parameters:
- required: true
schema:
type: string
title: Provider Type
name: provider_type
in: path
- required: false
schema:
type: string
title: Provider Id
name: provider_id
in: query
- required: false
schema:
type: string
title: Fingerprint
name: fingerprint
in: query
responses:
'202':
description: Successful Response
content:
application/json:
schema:
additionalProperties:
type: string
type: object
title: Response Receive Event Alerts Event Provider Type Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/{fingerprint}:
get:
tags:
- alerts
summary: Get Alert
description: Get alert by fingerprint
operationId: get_alert_alerts__fingerprint__get
parameters:
- required: true
schema:
type: string
title: Fingerprint
name: fingerprint
in: path
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AlertDto'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/enrich:
post:
tags:
- alerts
summary: Enrich Alert
description: Enrich an alert
operationId: enrich_alert_alerts_enrich_post
parameters:
- description: Dispose on new alert
required: false
schema:
type: boolean
title: Dispose On New Alert
description: Dispose on new alert
default: false
name: dispose_on_new_alert
in: query
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EnrichAlertRequestBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties:
type: string
type: object
title: Response Enrich Alert Alerts Enrich Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/unenrich:
post:
tags:
- alerts
summary: Unenrich Alert
description: Un-Enrich an alert
operationId: unenrich_alert_alerts_unenrich_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UnEnrichAlertRequestBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties:
type: string
type: object
title: Response Unenrich Alert Alerts Unenrich Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/search:
post:
tags:
- alerts
summary: Search Alerts
description: Search alerts
operationId: search_alerts_alerts_search_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SearchAlertsRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/AlertDto'
type: array
title: Response Search Alerts Alerts Search Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/audit:
post:
tags:
- alerts
summary: Get Multiple Fingerprint Alert Audit
description: Get alert timeline audit trail for multiple fingerprints
operationId: get_multiple_fingerprint_alert_audit_alerts_audit_post
requestBody:
content:
application/json:
schema:
items:
type: string
type: array
title: Fingerprints
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/AlertAuditDto'
type: array
title: Response Get Multiple Fingerprint Alert Audit Alerts Audit Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/{fingerprint}/audit:
get:
tags:
- alerts
summary: Get Alert Audit
description: Get alert timeline audit trail
operationId: get_alert_audit_alerts__fingerprint__audit_get
parameters:
- required: true
schema:
type: string
title: Fingerprint
name: fingerprint
in: path
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/AlertAuditDto'
type: array
title: Response Get Alert Audit Alerts Fingerprint Audit Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/alerts/quality/metrics:
get:
tags:
- alerts
summary: Get Alert Quality
description: Get alert quality
operationId: get_alert_quality_alerts_quality_metrics_get
parameters:
- required: false
schema:
items:
type: string
type: array
title: Fields
default: []
name: fields
in: query
- required: false
schema:
type: string
title: Time Stamp
name: time_stamp
in: query
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows:
get:
tags:
- alerts
summary: Get Workflows
description: Get workflows
operationId: get_workflows_workflows_get
parameters:
- required: false
schema:
type: boolean
title: Is V2
default: false
name: is_v2
in: query
responses:
'200':
description: Successful Response
content:
application/json:
schema:
anyOf:
- items:
$ref: '#/components/schemas/WorkflowDTO'
type: array
- items:
type: object
type: array
title: Response Get Workflows Workflows Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
post:
tags:
- alerts
summary: Create Workflow
description: Create or update a workflow
operationId: create_workflow_workflows_post
requestBody:
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_create_workflow_workflows_post'
required: true
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WorkflowCreateOrUpdateDTO'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/export:
get:
tags:
- alerts
summary: Export Workflows
description: export all workflow Yamls
operationId: export_workflows_workflows_export_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
type: string
type: array
title: Response Export Workflows Workflows Export Get
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/{workflow_id}/run:
post:
tags:
- alerts
summary: Run Workflow
description: Run a workflow
operationId: run_workflow_workflows__workflow_id__run_post
parameters:
- required: true
schema:
type: string
title: Workflow Id
name: workflow_id
in: path
requestBody:
content:
application/json:
schema:
type: object
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Run Workflow Workflows Workflow Id Run Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/test:
post:
tags:
- alerts
summary: Run Workflow From Definition
description: Test run a workflow from a definition
operationId: run_workflow_from_definition_workflows_test_post
requestBody:
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_run_workflow_from_definition_workflows_test_post'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Run Workflow From Definition Workflows Test Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/json:
post:
tags:
- alerts
summary: Create Workflow From Body
description: Create or update a workflow
operationId: create_workflow_from_body_workflows_json_post
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WorkflowCreateOrUpdateDTO'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/random-templates:
get:
tags:
- alerts
summary: Get Random Workflow Templates
description: Get random workflow templates
operationId: get_random_workflow_templates_workflows_random_templates_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
type: object
type: array
title: Response Get Random Workflow Templates Workflows Random Templates Get
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/{workflow_id}:
get:
tags:
- alerts
summary: Get Workflow By Id
description: Get workflow by ID
operationId: get_workflow_by_id_workflows__workflow_id__get
parameters:
- required: true
schema:
type: string
title: Workflow Id
name: workflow_id
in: path
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
put:
tags:
- alerts
summary: Update Workflow By Id
description: Update a workflow
operationId: update_workflow_by_id_workflows__workflow_id__put
parameters:
- required: true
schema:
type: string
title: Workflow Id
name: workflow_id
in: path
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WorkflowCreateOrUpdateDTO'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
delete:
tags:
- alerts
summary: Delete Workflow By Id
description: Delete workflow
operationId: delete_workflow_by_id_workflows__workflow_id__delete
parameters:
- required: true
schema:
type: string
title: Workflow Id
name: workflow_id
in: path
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/{workflow_id}/raw:
get:
tags:
- alerts
summary: Get Raw Workflow By Id
description: Get workflow executions by ID
operationId: get_raw_workflow_by_id_workflows__workflow_id__raw_get
parameters:
- required: true
schema:
type: string
title: Workflow Id
name: workflow_id
in: path
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: string
title: Response Get Raw Workflow By Id Workflows Workflow Id Raw Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/executions:
get:
tags:
- alerts
summary: Get Workflow Executions By Alert Fingerprint
description: Get workflow executions by alert fingerprint
operationId: get_workflow_executions_by_alert_fingerprint_workflows_executions_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/WorkflowToAlertExecutionDTO'
type: array
title: Response Get Workflow Executions By Alert Fingerprint Workflows Executions Get
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/{workflow_id}/runs:
get:
tags:
- alerts
summary: Get Workflow By Id
description: Get workflow executions by ID
operationId: get_workflow_by_id_workflows__workflow_id__runs_get
parameters:
- required: true
schema:
type: string
title: Workflow Id
name: workflow_id
in: path
- required: false
schema:
type: integer
title: Tab
default: 1
name: tab
in: query
- required: false
schema:
type: integer
title: Limit
default: 25
name: limit
in: query
- required: false
schema:
type: integer
title: Offset
default: 0
name: offset
in: query
- required: false
schema:
items:
type: string
type: array
title: Status
name: status
in: query
- required: false
schema:
items:
type: string
type: array
title: Trigger
name: trigger
in: query
- required: false
schema:
type: string
title: Execution Id
name: execution_id
in: query
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WorkflowExecutionsPaginatedResultsDto'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
/workflows/{workflow_id}/runs/{workflow_execution_id}:
get:
tags:
- alerts
summary: Get Workflow Execution Status
description: Get a workflow execution status
operationId: get_workflow_execution_status_workflows__workflow_id__runs__workflow_execution_id__get
parameters:
- required: true
schema:
type: string
title: Workflow Execution Id
name: workflow_execution_id
in: path
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WorkflowExecutionDTO'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- API Key: []
- HTTPBasic: []
- OAuth2PasswordBearer: []
components:
schemas:
SearchAlertsRequest:
properties:
query:
$ref: '#/components/schemas/PresetSearchQuery'
timeframe:
type: integer
title: Timeframe
type: object
required:
- query
- timeframe
title: SearchAlertsRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
AlertActionType:
enum:
- alert was triggered
- alert acknowledged
- alert automatically resolved
- alert automatically resolved by API
- alert manually resolved
- alert status manually changed
- alert status changed by API
- alert status undone
- alert enriched by workflow
- alert enriched by mapping rule
- alert was deduplicated
- alert was assigned with ticket
- alert was unassigned from ticket
- alert ticket was updated
- alert enrichments disposed
- alert deleted
- alert enriched
- alert un-enriched
- a comment was added to the alert
- a comment was removed from the alert
- Alert is in maintenance window
- A comment was added to the incident
title: AlertActionType
description: An enumeration.
AlertAuditDto:
properties:
id:
type: string
title: Id
timestamp:
type: string
format: date-time
title: Timestamp
fingerprint:
type: string
title: Fingerprint
action:
$ref: '#/components/schemas/AlertActionType'
user_id:
type: string
title: User Id
description:
type: string
title: Description
type: object
required:
- id
- timestamp
- fingerprint
- action
- user_id
- description
title: AlertAuditDto
PresetSearchQuery:
properties:
cel_query:
type: string
minLength: 0
title: Cel Query
sql_query:
type: object
title: Sql Query
limit:
type: integer
minimum: 0
title: Limit
default: 1000
timeframe:
type: integer
minimum: 0
title: Timeframe
default: 0
type: object
required:
- cel_query
- sql_query
title: PresetSearchQuery
AlertDto:
properties:
id:
type: string
title: Id
name:
type: string
title: Name
status:
$ref: '#/components/schemas/AlertStatus'
severity:
$ref: '#/components/schemas/AlertSeverity'
lastReceived:
type: string
title: Lastreceived
firingStartTime:
type: string
title: Firingstarttime
environment:
type: string
title: Environment
default: undefined
isFullDuplicate:
type: boolean
title: Isfullduplicate
default: false
isPartialDuplicate:
type: boolean
title: Ispartialduplicate
default: false
duplicateReason:
type: string
title: Duplicatereason
service:
type: string
title: Service
source:
items:
type: string
type: array
title: Source
default: []
apiKeyRef:
type: string
title: Apikeyref
message:
type: string
title: Message
description:
type: string
title: Description
pushed:
type: boolean
title: Pushed
default: false
event_id:
type: string
title: Event Id
url:
type: string
maxLength: 65536
minLength: 1
format: uri
title: Url
labels:
type: object
title: Labels
default: {}
fingerprint:
type: string
title: Fingerprint
deleted:
type: boolean
title: Deleted
default: false
dismissUntil:
type: string
title: Dismissuntil
dismissed:
type: boolean
title: Dismissed
default: false
assignee:
type: string
title: Assignee
providerId:
type: string
title: Providerid
providerType:
type: string
title: Providertype
note:
type: string
title: Note
startedAt:
type: string
title: Startedat
isNoisy:
type: boolean
title: Isnoisy
default: false
enriched_fields:
items: {}
type: array
title: Enriched Fields
default: []
incident:
type: string
title: Incident
type: object
required:
- name
- status
- severity
- lastReceived
title: AlertDto
example:
id: '1234'
name: Pod 'api-service-production' lacks memory
status: firing
lastReceived: '2021-01-01T00:00:00.000Z'
environment: production
service: backend
source:
- prometheus
message: The pod 'api-service-production' lacks memory causing high error rate
description: Due to the lack of memory, the pod 'api-service-production' is experiencing high error rate
severity: cr
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/keep/refs/heads/main/openapi/keep-alerts-api-openapi.yml