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

Render Metrics API

The `Metrics` endpoints allow you to retrieve metrics for your services, Postgres databases, and redis instances.

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

This API exposes 3 JSON Schema definitions.

Tagged areas include Metrics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, and 3 JSON Schemas.

This API exposes 23 operations across 21 paths, and defines 1 schema. It is described by OpenAPI 3.0.2, at version 1.0.0.

Requests are made against a single base URL, https://api.render.com/v1.

23 operations 21 paths 1 schemas 1 DELETE21 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
1.0.0
Base URL
https://api.render.com/v1
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

Render Metrics API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

Paths & Operations 23

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

Metrics 23

The Metrics endpoints allow you to retrieve metrics for your services, Postgres databases, and redis instances.

GET
/metrics-stream/{ownerId}
Retrieve metrics stream
getOwnerMetricsStream 1 param → 200400404500
PUT
/metrics-stream/{ownerId}
Create or update metrics stream
upsertOwnerMetricsStream 1 param body → 200400500
DELETE
/metrics-stream/{ownerId}
Delete metrics stream
deleteOwnerMetricsStream 1 param → 204400404500
GET
/metrics/cpu
Get CPU usage
get-cpu 7 params → 200400500
GET
/metrics/cpu-limit
Get CPU limit
get-cpu-limit 6 params → 200400500
GET
/metrics/cpu-target
Get CPU target
get-cpu-target 6 params → 200400500
GET
/metrics/memory
Get memory usage
get-memory 6 params → 200400500
GET
/metrics/memory-limit
Get memory limit
get-memory-limit 6 params → 200400500
GET
/metrics/memory-target
Get memory target
get-memory-target 6 params → 200400500
GET
/metrics/http-requests
Get HTTP request count
get-http-requests 8 params → 200400500
GET
/metrics/http-latency
Get HTTP latency
get-http-latency 8 params → 200400500
GET
/metrics/bandwidth
Get bandwidth usage
get-bandwidth 4 params → 200400500
GET
/metrics/bandwidth-sources
Get bandwidth usage breakdown by traffic source
get-bandwidth-sources 4 params → 200400500
GET
/metrics/disk-usage
Get disk usage
get-disk-usage 5 params → 200400500
GET
/metrics/disk-capacity
Get disk capacity
get-disk-capacity 5 params → 200400500
GET
/metrics/instance-count
Get instance count
get-instance-count 5 params → 200400500
GET
/metrics/active-connections
Get active connection count
get-active-connections 4 params → 200400500
GET
/metrics/replication-lag
Get replica lag
get-replication-lag 4 params → 200400500
GET
/metrics/filters/application
List queryable instance values
list-application-filter-values 5 params → 200400500
GET
/metrics/filters/http
List queryable status codes and host values
list-http-filter-values 7 params → 200400500
GET
/metrics/filters/path
List queryable paths
list-path-filter-values 8 params → 200400500
GET
/metrics/task-runs-queued
Get task runs queued count
get-task-runs-queued 4 params → 200400500
GET
/metrics/task-runs-completed
Get task runs completed count
get-task-runs-completed 6 params → 200400500

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is error (2 properties). Each schema is shown below with its type and property counts.

error
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

render-metrics-api-openapi.yml Raw ↑

Other APIs Render publishes across the network.

Render Audit Logs API
Render Blueprints API
Render Custom Domains API
Render Deploys API
Render Disks API
Render Environment Groups API
Render Events API
Render Key Value API
Render Logs API
Render Maintenance API
Render Notification Settings API
Render One-Off Jobs API