Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Keep groups API

The groups API from Keep — 2 operation(s) for groups.

Keep groups API is one of 27 APIs that Keep publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include groups. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 4 operations across 2 paths, and defines 4 schemas. It is described by OpenAPI 3.0.2, at version 0.24.5.

Requests are made against the base URL https://api.keephq.dev.

4 operations 2 paths 4 schemas 1 DELETE1 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
0.24.5
Base URL
https://api.keephq.dev
Authentication
API Key, HTTP Basic, OAuth 2.0
Resource Areas
1

Authentication & Security 3

Keep groups API declares 3 security schemes for authenticating requests. An API key is passed in the header as X-API-KEY (API Key). It accepts HTTP basic authentication (HTTPBasic). It supports OAuth 2.0 (OAuth2PasswordBearer) using the password flow.

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 1 DELETE, 1 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

groups 4
GET
/auth/groups
Get Groups
get_groups_auth_groups_get → 200
POST
/auth/groups
Create Group
create_group_auth_groups_post body → 200422
PUT
/auth/groups/{group_name}
Update Group
update_group_auth_groups__group_name__put 1 param body → 200422
DELETE
/auth/groups/{group_name}
Delete Group
delete_group_auth_groups__group_name__delete 1 param → 200422

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Group (5 properties), CreateOrUpdateGroupRequest (3 properties), ValidationError (3 properties), HTTPValidationError (1 property). Each schema is shown below with its type and property counts.

ValidationError
object
3 properties 3 required
Group
object
5 properties 2 required
HTTPValidationError
object
1 property
CreateOrUpdateGroupRequest
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

keep-groups-api-openapi.yml Raw ↑

Other APIs Keep publishes across the network.

Keep actions API
Keep alerts API
Keep auth API
Keep dashboard API
Keep deduplications API
Keep enrichment API
Keep extraction API
Keep healthcheck API
Keep incidents API
Keep Keep API API
Keep maintenance API
Keep mapping API