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

Netdata contexts API

Everything related contexts - in new code, use this instead of charts

Netdata contexts API is one of 20 APIs that Netdata publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include contexts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 7 operations across 7 paths, and defines 7 schemas. It is described by OpenAPI 3.0.0, at version v1-rolling.

Requests are made against 3 base URLs: https://registry.my-netdata.io, http://registry.my-netdata.io, http://localhost:19999.

7 operations 7 paths 7 schemas 7 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
v1-rolling
Base URL
http://localhost:19999
Authentication
HTTP Bearer, HTTP Bearer, API Key
License
Resource Areas
1

Authentication & Security 3

Netdata contexts API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP bearer tokens (aclkAuth). An API key is passed in the header as X-Forwarded-For (ipAcl).

  • bearerAuth — Bearer token authentication for API access when bearer protection is enabled. How to obtain a token: 1. Token must be obtained via /api/v3/bearergettoken endpo…
  • aclkAuth — ACLK-only authentication - these APIs are ONLY accessible via Netdata Cloud (ACLK). Access Requirements: - User must be authenticated via Netdata Cloud (SIGNED…
  • ipAcl — IP-based Access Control List restrictions (informational only). Configuration: APIs are subject to IP-based ACL restrictions configured in netdata.conf: conf […

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 GET. Each is listed below with its method, path, parameters, and response codes.

contexts 7

Everything related contexts - in new code, use this instead of charts

GET
/api/v2/contextsdeprecated
Contexts Info v2
getContexts2 5 params → 200
GET
/api/v3/contexts
Contexts Info v3
getContexts3 5 params → 200
GET
/api/v2/qdeprecated
Full Text Search v2
q2 6 params → 200
GET
/api/v3/q
Full Text Search v3
q3 6 params → 200
GET
/api/v1/contextsdeprecated
Get a list of all node contexts available v1
getNodeContexts1 6 params → 200
GET
/api/v1/contextdeprecated
Get info about a specific context
getNodeContext1 7 params → 200400404
GET
/api/v3/context
Get info about a specific context - Latest API
getNodeContext3 7 params → 200400404500

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are context (10 properties), context_summary (6 properties), versions (5 properties), context2Basic (5 properties). Each schema is shown below with its type and property counts.

agents
array
An array of Agent definitions consulted to compose this response.
context
object
10 properties
api
integer
The version of the API used.
context2Basic
object
5 properties
context_summary
object
6 properties
versions
object
Hashes that allow the caller to detect important database changes of Netdata Agents.
5 properties
contexts2
object
/api/v2/contexts and /api/v2/q response about multi-node contexts hosted by a Netdata Agent.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

netdata-contexts-api-openapi.yml Raw ↑

Other APIs Netdata publishes across the network.

Netdata Agent API
Netdata alerts API
Netdata authentication API
Netdata badges API
Netdata charts API
Netdata claiming API
Netdata config API
Netdata data API
Netdata dyncfg API
Netdata functions API
Netdata management API
Netdata nodes API