NotificationEndpoints

Download InfluxDB API Spec
Create and manage notification endpoints that receive alert notifications from InfluxDB OSS v2 monitoring checks.
GET /api/v2/notificationEndpoints

List all notification endpoints

Parameters

Query parameters
offset integer

The offset for pagination. The number of records to skip.

For more information about pagination parameters, see Pagination.

limit integer
Limits the number of records returned. Default is 20.
Default: 20
orgID required string
Only show notification endpoints that belong to specific organization ID.
Header parameters
Zap-Trace-Span string
OpenTracing span context
Example request Ask AI about this
curl --request GET \
  "http://localhost:8086/api/v2/notificationEndpoints?orgID=ORGID" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 A list of notification endpoints
links object
URI pointers for additional paged results.
next string <uri>
URI of resource.
prev string <uri>
URI of resource.
self required string <uri>
URI of resource.
notificationEndpoints object[]
default Unexpected error
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.
POST /api/v2/notificationEndpoints

Add a notification endpoint

Request body required

Notification endpoint to create
Content-Type: application/json
Example request Ask AI about this
curl --request POST \
  "http://localhost:8086/api/v2/notificationEndpoints" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json"

Responses

201 Notification endpoint created
default Unexpected error
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.
GET /api/v2/notificationEndpoints/{endpointID}

Retrieve a notification endpoint

Parameters

Path parameters
endpointID required string
The notification endpoint ID.
Header parameters
Zap-Trace-Span string
OpenTracing span context
Example request Ask AI about this
curl --request GET \
  "http://localhost:8086/api/v2/notificationEndpoints/{endpointID}" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 The notification endpoint requested
default Unexpected error
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.
PUT /api/v2/notificationEndpoints/{endpointID}

Update a notification endpoint

Parameters

Path parameters
endpointID required string
The notification endpoint ID.
Header parameters
Zap-Trace-Span string
OpenTracing span context

Request body required

A new notification endpoint to replace the existing endpoint with
Content-Type: application/json
Example request Ask AI about this
curl --request PUT \
  "http://localhost:8086/api/v2/notificationEndpoints/{endpointID}" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json"

Responses

200 An updated notification endpoint
404 The notification endpoint was not found
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.
default Unexpected error
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.
PATCH /api/v2/notificationEndpoints/{endpointID}

Update a notification endpoint

Parameters

Path parameters
endpointID required string
The notification endpoint ID.
Header parameters
Zap-Trace-Span string
OpenTracing span context

Request body required

Check update to apply
Content-Type: application/json
description string
name string
status string
Allowed: active , inactive
Example request Ask AI about this
curl --request PATCH \
  "http://localhost:8086/api/v2/notificationEndpoints/{endpointID}" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "description": "DESCRIPTION",
  "name": "NAME",
  "status": "active"
}'

Responses

200 An updated notification endpoint
404 The notification endpoint was not found
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.
default Unexpected error
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.
DELETE /api/v2/notificationEndpoints/{endpointID}