Perses website screenshot

Perses

Perses is an open-source monitoring and dashboarding tool designed as a modern alternative for visualizing time-series data with a focus on performance, extensibility, and GitOps. Perses exposes a REST API for managing dashboards, datasources, ephemeral dashboards, projects, roles, role bindings, secrets, users, variables, plugins, validation, and migrations. It is a CNCF sandbox project.

Perses publishes 4 APIs on the APIs.io network, including Dashboards API, Datasources API, Global Datasources API, and 1 more. Tagged areas include CNCF, Dashboards, Monitoring, Observability, and Open Source.

Perses’ developer surface includes documentation, API reference, GitHub presence, engineering blog, and 6 more developer resources.

🌐 Visit website 📡 Source on GitHub
36.0/100 thin ▬ flat Agent 32/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
5 APIs 1 MCP Servers
CNCFDashboardsMonitoringObservabilityOpen SourceTime SeriesVisualization

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 36.0/100 · thin
Contract Quality 10.8 / 25
Developer Ergonomics 6.1 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 0.0 / 12
Discoverability 6.5 / 10
Agent readiness — 32/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/perses: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Perses API

The Perses REST API provides programmatic access to dashboards, datasources, ephemeral dashboards, projects, roles, role bindings, secrets, users, variables, plugins, validation...

Perses Dashboards API

Manage dashboards inside a project.

Perses Datasources API

Manage project-scoped datasources.

Perses Global Datasources API

Manage shared datasources across projects.

Perses Projects API

Manage Perses projects (workspaces).

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Perses API

OPEN COLLECTION

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

MCP Server

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Perses Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Perses Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Perses Finops

FINOPS

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Perses Domain Security

TLSv1.3

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Perses Agentic Access

20 operations · 12 acting

20 operations · 12 acting

AGENTIC

Resources

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 MCPServer
MCPServer

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 GitHub
GitHub

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

Community
Community

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: perses
name: Perses
description: Perses is an open-source monitoring and dashboarding tool designed as a modern alternative for visualizing time-series
  data with a focus on performance, extensibility, and GitOps. Perses exposes a REST API for managing dashboards, datasources,
  ephemeral dashboards, projects, roles, role bindings, secrets, users, variables, plugins, validation, and migrations. It
  is a CNCF sandbox project.
type: Index
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
position: Producer
access: Open Source
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/perses.png
tags:
- CNCF
- Dashboards
- Monitoring
- Observability
- Open Source
- Time Series
- Visualization
url: https://raw.githubusercontent.com/api-evangelist/perses/refs/heads/main/apis.yml
created: '2026-03-16'
modified: '2026-05-19'
specificationVersion: '0.19'
apis:
- aid: perses:perses
  name: Perses API
  description: The Perses REST API provides programmatic access to dashboards, datasources, ephemeral dashboards, projects,
    roles, role bindings, secrets, users, variables, plugins, validation, and migration resources for the Perses monitoring
    and dashboarding platform.
  humanURL: https://perses.dev/
  tags:
  - Dashboards
  - Monitoring
  - Observability
  properties:
  - type: Documentation
    url: https://perses.dev/perses/docs/
  - type: APIReference
    url: https://perses.dev/perses/docs/api/
  - type: GitHub
    url: https://github.com/perses/perses
- aid: perses:perses-dashboards-api
  name: Perses Dashboards API
  description: Manage dashboards inside a project.
  humanURL: https://perses.dev/
  tags:
  - Dashboards
  properties:
  - type: OpenAPI
    url: openapi/perses-dashboards-api-openapi.yml
- aid: perses:perses-datasources-api
  name: Perses Datasources API
  description: Manage project-scoped datasources.
  humanURL: https://perses.dev/
  tags:
  - Datasources
  properties:
  - type: OpenAPI
    url: openapi/perses-datasources-api-openapi.yml
- aid: perses:perses-global-datasources-api
  name: Perses Global Datasources API
  description: Manage shared datasources across projects.
  humanURL: https://perses.dev/
  tags:
  - Global Datasources
  properties:
  - type: OpenAPI
    url: openapi/perses-global-datasources-api-openapi.yml
- aid: perses:perses-projects-api
  name: Perses Projects API
  description: Manage Perses projects (workspaces).
  humanURL: https://perses.dev/
  tags:
  - Projects
  properties:
  - type: OpenAPI
    url: openapi/perses-projects-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/perses-agentic-access.yml
- type: DomainSecurity
  url: security/perses-domain-security.yml
- type: Website
  url: https://perses.dev/
- type: Documentation
  url: https://perses.dev/perses/docs/
- type: APIReference
  url: https://perses.dev/perses/docs/api/
- type: GitHubOrganization
  url: https://github.com/perses
- type: GitHub
  url: https://github.com/perses/perses
- type: Community
  url: https://perses.dev/community/
- type: Blog
  url: https://perses.dev/blog/
- name: MCP Server
  url: https://github.com/perses/mcp-server
  type: MCPServer
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com