Cronitor Notifications API
The Notifications API from Cronitor — 2 operation(s) for notifications.
The Notifications API from Cronitor — 2 operation(s) for notifications.
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/cronitor-notifications-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: Cronitor Groups Notifications API
description: The Groups API manages logical groupings of monitors for bulk operations and reporting. The Notifications API manages notification lists (alert routing) that specify where alerts are sent when monitors fire. Both APIs use HTTP Basic Auth with a Cronitor API key.
version: v1
contact:
name: Cronitor Support
url: https://cronitor.io/docs/groups-api
license:
name: Proprietary
url: https://cronitor.io
servers:
- url: https://cronitor.io
description: Cronitor production server
security:
- basicAuth: []
tags:
- name: Notifications
paths:
/api/notifications:
get:
operationId: listNotificationLists
summary: List notification lists
description: Returns a paginated list of notification lists.
parameters:
- name: page
in: query
schema:
type: integer
default: 1
- name: pageSize
in: query
schema:
type: integer
default: 50
responses:
'200':
description: List of notification lists.
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationListResponse'
'403':
description: Forbidden.
tags:
- Notifications
post:
operationId: createNotificationList
summary: Create a notification list
description: Creates a new notification list.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationList'
responses:
'201':
description: Notification list created.
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationList'
'400':
description: Validation error.
'403':
description: Forbidden.
tags:
- Notifications
/api/notifications/{key}:
parameters:
- name: key
in: path
required: true
schema:
type: string
description: Notification list key.
get:
operationId: getNotificationList
summary: Get a notification list
description: Retrieves a single notification list by key.
responses:
'200':
description: Notification list object.
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationList'
'403':
description: Forbidden.
'404':
description: Not found.
tags:
- Notifications
put:
operationId: updateNotificationList
summary: Update a notification list
description: Updates an existing notification list.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationList'
responses:
'200':
description: Updated notification list.
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationList'
'400':
description: Validation error.
'403':
description: Forbidden.
'404':
description: Not found.
tags:
- Notifications
delete:
operationId: deleteNotificationList
summary: Delete a notification list
description: Deletes a notification list. Cannot delete the "default" list.
responses:
'204':
description: Notification list deleted.
'400':
description: Cannot delete the default notification list.
'403':
description: Forbidden.
'404':
description: Not found.
tags:
- Notifications
components:
schemas:
NotificationList:
type: object
required:
- name
- notifications
properties:
key:
type: string
readOnly: true
description: Unique identifier for the notification list.
example: devops-team
name:
type: string
description: Display name.
example: DevOps Team
notifications:
type: object
description: Alert destination targets.
properties:
emails:
type: array
items:
type: string
format: email
phones:
type: array
items:
type: string
slack:
type: array
items:
type: string
pagerduty:
type: array
items:
type: string
opsgenie:
type: array
items:
type: string
victorops:
type: array
items:
type: string
microsoft-teams:
type: array
items:
type: string
discord:
type: array
items:
type: string
telegram:
type: array
items:
type: string
gchat:
type: array
items:
type: string
larksuite:
type: array
items:
type: string
webhooks:
type: array
items:
type: string
format: uri
environments:
type: array
items:
type: object
properties:
key:
type: string
monitors:
type: integer
readOnly: true
description: Count of associated monitors.
monitor_details:
type: array
readOnly: true
description: Array of associated monitor objects.
status:
type: string
readOnly: true
created:
type: string
format: date-time
readOnly: true
NotificationListResponse:
type: object
properties:
page:
type: integer
page_size:
type: integer
total_template_count:
type: integer
templates:
type: array
items:
$ref: '#/components/schemas/NotificationList'
securitySchemes:
basicAuth:
type: http
scheme: basic
description: Use your Cronitor API key as the username; leave the password blank.