PmaControl logo PmaControl
  • Home
  • PmaControl
    • AI Agents 13 on-premise agents
    • Plans Community, Cloud, On-Premise, Premium
    • Documentation Guides, API, architecture
    • Changelog Every stable 5.x release
    • Marketplace Community plugins
    • Clients 28+ companies
    • FAQ 25 questions / 7 categories
    Databases
    • MariaDB 35 articles
    • MySQL 15 articles
    • Galera Cluster 6 articles
    • MaxScale 4 articles
    • ProxySQL 3 articles
    • Amazon Aurora MySQL 0 article
    • Azure Database 0 article
    • ClickHouse 0 article
    • GCP CloudSQL 0 article
    • Percona Server 0 article
    • SingleStore 0 article
    • TiDB 0 article
    • Vitess 0 article
    Solutions
    • Support 24×7 MariaDB & MySQL emergencies
    • SQL Observability Monitoring, alerts, topology
    • High Availability Replication, failover, Galera
    • Disaster Recovery Backup, restore, RPO/RTO
    • Security & Compliance Audit, GDPR, SOC2
    • Migration & Upgrade Zero downtime, pt-osc, gh-ost
  • Plans
  • Resources
    • Documentation Technical guides & API
    • MySQL optimization center Markdown index, metrics, parameters, incidents
    • FAQ 25 frequently asked questions
    • Testimonials Client feedback & use cases
    • Blog Articles & insights
    • Roadmap Upcoming features
    Areas of expertise
    • SQL Observability Monitoring, alerts, Dot3 topology
    • High Availability Replication, failover, Galera
    • Security & Compliance Audit, GDPR, SOC2, ISO 27001
    • Disaster Recovery Backup, restore, RPO/RTO
    • Performance & Optimisation Digests, EXPLAIN, tuning
    • Migration & Upgrade Zero downtime, pt-osc
    Quick links
    • GitHub Wiki 26 pages — install, engine, plugins
    • Source code Official GitHub repository
    • Support 24×7 MariaDB & MySQL emergencies
    • Book a demo 30 min — real architecture
  • Support 24×7
  • Book a demo
Book a demo
🇫🇷 FR Français 🇬🇧 EN English 🇵🇱 PL Polski 🇷🇺 RU Русский 🇨🇳 ZH 中文 🇸🇦 AR العربية

PmaControl — developers and API

Quick start

Query the public resources below with curl. No account, sales form or API key is needed for this read-only API. Responses use JSON.

curl -sS https://www.pmacontrol.com/api/v1/capabilities
curl -sS 'https://www.pmacontrol.com/api/v1/documentation?language=en'
curl -sS https://www.pmacontrol.com/api/v1/permissions

Authentication and permissions

Discovery resources and the public sandbox remain available without credentials. To test an authenticated integration, self-register a confidential OAuth client at /oauth/register, then request a client_credentials token at /oauth/token. The sandbox.servers.read and sandbox.identity.read scopes are declared in OpenAPI and enforced on protected routes. Client secrets expire after 24 hours and tokens after at most 600 seconds. These credentials grant no access to customer installations; their access remains separately administered.

Contract and errors

The OpenAPI contract describes every operation, parameter and response. API errors use application/problem+json. Public requests are limited to 300 per client IP in 60 seconds. RateLimit-Policy and RateLimit declare the policy, remaining quota and seconds until reset; RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset are also provided for compatibility. After HTTP 429, wait for the seconds in Retry-After. These fields follow IETF draft httpapi-ratelimit-headers-11; no availability guarantee is promised.

Free sandbox

Test a synthetic MariaDB / MySQL response without an account or key. Metrics are fixed examples with no connection to customer databases. This sandbox is read-only and does not simulate production permissions. The existing Pro trial requires email verification and an installation UUID; its license is not an API key.

curl -sS https://www.pmacontrol.com/api/v1/sandbox/servers

Official PmaControl CLI

Install the CLI from the official Homebrew tap on macOS or Linux. The formula uses Python 3.13 and verifies the published source archive with SHA-256. The capabilities, permissions, schema, docs and sandbox commands return JSON without an account or key. The package and its source are publicly accessible on this website.

brew tap pmacontrol/agent https://www.pmacontrol.com/downloads/homebrew-agent.git
brew install pmacontrol/agent/pmacontrol-agent
pmacontrol-agent --version
pmacontrol-agent capabilities
pmacontrol-agent docs --language fr
pmacontrol-agent sandbox

Self-service sandbox credentials

The flow below creates a client ID and secret without signup or payment, then a token limited to sandbox.servers.read. Replace CLIENT_ID, CLIENT_SECRET and ACCESS_TOKEN with the returned values. To test client identity, explicitly request sandbox.identity.read. Registration is limited to five clients per hour per IP and 120 per hour for the service; the token endpoint accepts 30 requests per minute per IP. Current quota headers and Retry-After take precedence.

curl -sS https://www.pmacontrol.com/oauth/register \
  -H 'Content-Type: application/json' \
  --data '{"grant_types":["client_credentials"],"response_types":[],"scope":"sandbox.servers.read"}'
curl -sS https://www.pmacontrol.com/oauth/token \
  --user 'CLIENT_ID:CLIENT_SECRET' \
  --data 'grant_type=client_credentials&scope=sandbox.servers.read'
curl -sS https://www.pmacontrol.com/api/v1/sandbox/authorized-servers \
  -H 'Authorization: Bearer ACCESS_TOKEN'

Machine-readable onboarding guide

API versioning and deprecation

REST API v1 is active and the current contract version is 1.1.0. Compatible additions use a minor version; breaking changes require a new major URL, such as /api/v2. No v1 retirement is scheduled. Before retirement, we publish a dated notice and migration guide at least 90 days in advance, except for a documented security emergency or legal requirement.

When a resource is deprecated, Deprecation carries an RFC 9745 Structured Field Date as @Unix_seconds and Sunset carries the retirement HTTP-date in GMT under RFC 8594. Sunset is never earlier than Deprecation. The HTTP rel=deprecation link points to this policy and migration instructions. Active resources expose that link without announcing a fictional date.

Machine-readable API policy

Resources

  • OpenAPI 3.1
  • llms.txt
  • OAuth 2.0 — RFC 8414
  • OAuth 2.0 — RFC 9728
  • OpenAPI → function calling
  • PmaControl CLI — Homebrew
  • Product documentation
  • Three-month Pro trial
PmaControl
contact@pmacontrol.com
About Privacy Legal notice GitHub Developers Contact
Do not wait for an incident to understand your architecture. © 2014-2026 PmaControl — 68Koncept