# Opservo API

**Canonical:** https://apis.io/apis/getopservo-com/getopservo-com-api/  
**Provider:** Opservo — https://apis.io/providers/getopservo-com/  
**Base URL:** https://api.getopservo.com  
**Documentation:** https://getopservo.com/docs/api-tokens

Opservo API is one of 2 APIs that [Opservo](https://apis.io/providers/getopservo-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 3 JSON Schemas.

Opservo API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-11-10); not the provider's own document.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/agents/` | The Opservo data source lets you chart any of the 80+ server metrics Opservo collects inside the Grafana dashboards you already have. |
| POST | `/api/v1/agents/{id}/deploy` | Trigger the server’s configured deploy; body {"ref": "<commit or tag>"} is optional |
| POST | `/api/v1/agents/{id}/deploy/rollback` | Run the configured rollback command |
| GET | `/api/v1/agents/{id}/deploys` | Release history with status and logs |
| GET | `/api/v1/agents/{id}/metrics/prometheus` | The same for one server |
| GET | `/api/v1/metrics/catalogue` | The list of exportable metrics as JSON |
| POST | `/api/v1/metrics/catalogue` | POST /api/v1/metrics/catalogue |
| GET | `/api/v1/metrics/prometheus` | Every metric for every server, Prometheus text format |
| GET | `/api/v1/metrics/query` | Bucketed time series for up to 20 metrics, optional agent_ids , hours 1–720 |
| POST | `/api/v1/metrics/query` | Bucketed time series for up to 20 metrics, optional agent_ids , hours 1–720 |
| GET | `/api/v1/uptime/heartbeat/{token}` | GET /api/v1/uptime/heartbeat/{token} |
| POST | `/api/v2/series` | Prometheus metrics endpoint |
| GET | `/install.sh` | GET /install.sh |
| POST | `/mcp` | Read-only MCP server for Claude, Cursor and VS Code; see MCP server |

## Machine-readable artifacts (4)

- **OpenAPI** — https://artifacts.apis.io/getopservo-com/openapi/_ae-authored/getopservo-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/getopservo-com/json-schema/getopservo-com-post-api-v2-series-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/getopservo-com/json-schema/getopservo-com-post-api-v1-metrics-query-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/getopservo-com/json-schema/getopservo-com-post-api-v1-agents-id-deploy-request-schema.json

## Other Opservo APIs (1)

- [Opservo API](https://apis.io/apis/getopservo-com/opservo-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/getopservo-com/getopservo-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/getopservo-com/.