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

InfluxDB Checks API

The Checks API from InfluxDB — 5 operation(s) for checks.

InfluxDB Checks API is one of 40 APIs that InfluxDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Checks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, authentication docs, and a getting-started guide.

This API exposes 10 operations across 5 paths, and defines 32 schemas. It is described by OpenAPI 3.0.0.

Requests are made against the base URL https://cloud2.influxdata.com/api/v2.

10 operations 5 paths 32 schemas 2 DELETE4 GET1 PATCH2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
Base URL
https://cloud2.influxdata.com/api/v2
Authentication
HTTP Basic, API Key
Resource Areas
1

Authentication & Security 2

InfluxDB Checks API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (BasicAuthentication). An API key is passed in the header as Authorization (TokenAuthentication). By default, every request must be authenticated.

  • BasicAuthentication — Basic authentication scheme Use the HTTP Basic authentication scheme for InfluxDB /api/v2 API operations that support it: Syntax Authorization: Basic BASE64ENC…
  • TokenAuthentication — Use the [Token authentication](section/Authentication/TokenAuthentication) scheme to authenticate to the InfluxDB API. In your API requests, send an Authorizat…

Paths & Operations 10

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

Checks 10
GET
/api/v2/checks
List all checks
GetChecks 4 params → 200default
POST
/api/v2/checks
Add new check
CreateCheck body → 201default
DELETE
/api/v2/checks/{checkID}
Delete a check
DeleteChecksID 2 params → 204404default
GET
/api/v2/checks/{checkID}
Retrieve a check
GetChecksID 2 params → 200default
PATCH
/api/v2/checks/{checkID}
Update a check
PatchChecksID 2 params body → 200404default
PUT
/api/v2/checks/{checkID}
Update a check
PutChecksID 2 params body → 200404default
GET
/api/v2/checks/{checkID}/labels
List all labels for a check
GetChecksIDLabels 2 params → 200default
POST
/api/v2/checks/{checkID}/labels
Add a label to a check
PostChecksIDLabels 2 params body → 201default
DELETE
/api/v2/checks/{checkID}/labels/{labelID}
Delete label from a check
DeleteChecksIDLabelsID 3 params → 204404default
GET
/api/v2/checks/{checkID}/query
Retrieve a check query
GetChecksIDQuery 2 params → 200400404default

Schemas 32

The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are CheckBase (15 properties), BuilderConfig (4 properties), Error (4 properties), Label (4 properties). Each schema is shown below with its type and property counts.

BuilderAggregateFunctionType
string
Link
string
URI of resource.
ErrorCode
string
code is the machine-readable error code.
LabelResponse
object
2 properties
Checks
object
2 properties
DeadmanCheck
CheckDiscriminator
BuilderFunctionsType
object
1 property
DashboardQuery
object
4 properties
Label
object
4 properties
GreaterThreshold
Labels
array
LesserThreshold
Error
object
4 properties 1 required
BuilderTagsType
object
3 properties
CheckStatusLevel
string
The state to record if check matches a criteria.
BuilderConfig
object
4 properties
CheckPatch
object
3 properties
FluxResponse
object
Rendered flux that backs the check or notification.
1 property
PostCheck
CustomCheck
RangeThreshold
QueryEditMode
string
TaskStatusType
string
inactive cancels scheduled runs and prevents manual runs of the task.
Links
object
URI pointers for additional paged results.
3 properties 1 required
LabelsResponse
object
2 properties
Threshold
ThresholdCheck
ThresholdBase
object
2 properties
Check
CheckBase
object
15 properties 3 required
LabelMapping
object
A label mapping contains a label ID to attach to a resource.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

influxdb-checks-api-openapi.yml Raw ↑

Other APIs InfluxDB publishes across the network.

InfluxDB Authorizations (API tokens) API
InfluxDB Bucket Schemas API
InfluxDB Buckets API
InfluxDB Cells API
InfluxDB Config API
InfluxDB Dashboards API
InfluxDB Data I/O endpoints API
InfluxDB DBRPs API
InfluxDB Delete API
InfluxDB Invokable Scripts API
InfluxDB Labels API
InfluxDB Legacy Authorizations API