Cronitor Groups API
The Groups API from Cronitor — 3 operation(s) for groups.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cronitor-groups-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
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 Specification
openapi: 3.2.0
info:
title: Cronitor and Notifications Groups 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: Groups
paths:
/api/groups:
get:
operationId: listGroups
summary: List groups
description: Returns a paginated list of monitor groups.
parameters:
- name: page
in: query
schema:
type: integer
default: 1
- name: pageSize
in: query
schema:
type: integer
default: 50
- name: env
in: query
schema:
type: string
- name: withStatus
in: query
schema:
type: boolean
responses:
'200':
description: List of groups.
content:
application/json:
schema:
$ref: '#/components/schemas/GroupListResponse'
'403':
description: Forbidden.
tags:
- Groups
post:
operationId: createGroup
summary: Create a group
description: Creates a new monitor group.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
responses:
'201':
description: Group created.
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
'400':
description: Validation error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden.
tags:
- Groups
/api/groups/{key}:
parameters:
- name: key
in: path
required: true
schema:
type: string
description: Group key.
get:
operationId: getGroup
summary: Get a group
description: Retrieves a single group by key.
parameters:
- name: env
in: query
schema:
type: string
- name: withStatus
in: query
schema:
type: boolean
- name: sort
in: query
schema:
type: string
responses:
'200':
description: Group object.
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
'403':
description: Forbidden.
'404':
description: Group not found.
tags:
- Groups
put:
operationId: updateGroup
summary: Update a group
description: Updates the name or member monitors of a group. The monitors array replaces the existing member list entirely.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
monitors:
type: array
items:
type: string
responses:
'200':
description: Updated group object.
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
'400':
description: Validation error.
'403':
description: Forbidden.
'404':
description: Group not found.
tags:
- Groups
delete:
operationId: deleteGroup
summary: Delete a group
description: Deletes a group.
responses:
'204':
description: Group deleted.
'403':
description: Forbidden.
'404':
description: Group not found.
tags:
- Groups
/api/groups/{key}/pause/{hours}:
parameters:
- name: key
in: path
required: true
schema:
type: string
- name: hours
in: path
required: true
schema:
type: string
description: Hours to pause all monitors in the group; 0 to resume.
get:
operationId: pauseGroupMonitors
summary: Pause or resume all monitors in a group
description: Pauses all monitors in the group for the specified number of hours.
responses:
'200':
description: Updated group object.
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
'403':
description: Forbidden.
'404':
description: Group not found.
tags:
- Groups
components:
schemas:
Group:
type: object
required:
- name
properties:
key:
type: string
description: Unique group identifier.
example: backend-jobs
name:
type: string
description: Display name.
example: Backend Jobs
monitors:
type: array
items:
type: string
description: Array of member monitor keys.
example:
- daily-backup
- weekly-report
created:
type: string
format: date-time
readOnly: true
description: ISO 8601 creation timestamp.
latest_event:
type: object
readOnly: true
properties:
stamp:
type: integer
state:
type: string
latest_issue:
type:
- object
- 'null'
readOnly: true
Error:
type: object
properties:
error:
type: string
errors:
type: array
items:
type: string
GroupListResponse:
type: object
properties:
page:
type: integer
page_size:
type: integer
count:
type: integer
groups:
type: array
items:
$ref: '#/components/schemas/Group'
securitySchemes:
basicAuth:
type: http
scheme: basic
description: Use your Cronitor API key as the username; leave the password blank.