For Agents
Provision and operate managed PostgreSQL, Kafka, ClickHouse, OpenSearch, and other open-source data services across major clouds via Aiven.
Get started with Aiven API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create an Aiven PostgreSQL or Kafka service"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Aiven API API.
Provision a managed service (PostgreSQL, Kafka, ClickHouse, OpenSearch, MySQL, Redis) inside a project
Configure service integrations between databases, monitoring, and external sinks via the Service Integrations endpoints
Manage Kafka topics, ACL entries, quotas, and schema registry through the Kafka-specific operations
Run ClickHouse queries and manage databases through the Service: ClickHouse endpoints
GET STARTED
Use for: Provision a new managed PostgreSQL service in Aiven, Create a Kafka topic with specific partition and retention settings, List all services running in an Aiven project, Set up a service integration to send Kafka logs to OpenSearch
Not supported: Does not handle bare-metal compute, generic VM provisioning, or non-Aiven workloads — use for Aiven-managed open-source data services, projects, and organizations only.
The Aiven API gives programmatic control over Aiven's managed open-source data platform, covering provisioning and operation of services such as PostgreSQL, Kafka, ClickHouse, OpenSearch, MySQL, Redis, Cassandra, Flink, and Grafana on AWS, GCP, Azure, DigitalOcean, and UpCloud. Endpoints span organizations, projects, services, integrations, billing, governance, and per-engine operations such as Kafka topics, ClickHouse queries, and PostgreSQL connection pools. Authentication is via a personal token (Authorization: aivenv1 token) or OAuth 2.0. Suited for platform teams that automate database provisioning, GitOps-driven infrastructure, and SRE-grade fleet management.
Manage organizations, projects, billing groups, payment methods, and invoices
Configure user access, groups, and authentication methods at the organization level
Trigger and monitor service maintenance, upgrades, and backup restorations
Patterns agents use Aiven API API for, with concrete tasks.
★ Database provisioning automation
Automate per-environment database provisioning by calling /project/{project}/service to create a PostgreSQL or Kafka service from a Terraform-style intent. The API returns the connection URI once the service reaches RUNNING state, which a CI pipeline can write into application secrets. Replaces clickops in the Aiven console for staging and ephemeral environments and gives platform teams a typed contract.
POST to /project/myproj/service with service_type=pg, plan=startup-4, cloud=aws-eu-west-1, then poll until state=RUNNING and return service_uri.
Kafka topic and ACL management
Manage the full lifecycle of Kafka topics, ACL entries, and schema registry subjects without granting humans cluster admin. The Service: Kafka endpoints let an automation actor create topics with the right partition count, restrict producer/consumer ACLs to specific principals, and publish schemas to the registry. Underpins data-platform self-service portals.
POST to /project/{project}/service/{service_name}/topic with topic_name, partitions=12, replication=3, then POST an ACL granting a service account write access.
Cross-service observability wiring
Stand up a logging and metrics pipeline by creating an Aiven OpenSearch and Grafana service, then using the Service Integrations endpoints to fan logs and metrics from every other service into them. A platform team can offer 'logs to OpenSearch' as a one-click feature for application teams without each team configuring their own sinks. Reduces observability drift across a fleet of services.
POST to /project/{project}/integration with integration_type=logs, source_service=my-kafka, dest_service=my-opensearch.
Agent integration via Jentic
Give an SRE agent a typed surface over Aiven's 445 operations through Jentic. The agent can answer 'spin up a Postgres for staging' or 'add this consumer ACL on the prod Kafka cluster' in a single tool call, with the personal token kept inside the Jentic vault. Avoids hand-rolling a thin client per workflow.
Search Jentic for 'create Aiven PostgreSQL service', load the relevant /project/{project}/service POST operation, and execute it with the requested service_type and plan.
445 endpoints — the aiven api gives programmatic control over aiven's managed open-source data platform, covering provisioning and operation of services such as postgresql, kafka, clickhouse, opensearch, mysql, redis, cassandra, flink, and grafana on aws, gcp, azure, digitalocean, and upcloud.
METHOD
PATH
DESCRIPTION
/account
List Aiven accounts
/account/{account_id}
Retrieve a specific account
/account/{account_id}/payment_methods
List payment methods on an account
/account/{account_id}/billing-group
List billing groups on an account
/account/{account_id}/authentication
List authentication methods on an account
/account/{account_id}/events
List recent events on an account
/account
List Aiven accounts
/account/{account_id}
Retrieve a specific account
/account/{account_id}/payment_methods
List payment methods on an account
/account/{account_id}/billing-group
List billing groups on an account
/account/{account_id}/authentication
List authentication methods on an account
Three things that make agents converge on Jentic-routed access.
Credential isolation
Aiven personal tokens (aivenv1) and OAuth tokens sit encrypted in the Jentic vault. Agents call the 445 operations via scoped execution rights and never see the raw token, simplifying rotation and audit.
Intent-based discovery
Agents search by intent (e.g. 'create Aiven PostgreSQL service') and Jentic returns the matching operation from across the 445 endpoints, so the agent does not need to traverse Aiven's tag-heavy spec by hand.
Time to first call
Direct Aiven integration: 1-2 weeks to map the broad surface, handle paging, and wire service-state polling. Through Jentic: under 1 hour — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
DigitalOcean API
Cloud platform with its own managed databases and droplets as an alternative DBaaS
Choose DigitalOcean when an agent needs basic managed Postgres/Redis with simpler pricing; choose Aiven for multi-cloud and the broader open-source engine portfolio (Kafka, ClickHouse, OpenSearch).
Linode (Akamai) API
Cloud compute and managed database alternative for simpler workloads
Choose Linode for compute-centric workloads; choose Aiven when the agent needs cross-cloud managed open-source data services with integrations.
Scaleway API
Underlying European cloud platform that can host applications connecting to Aiven services
Use Scaleway for compute and Aiven for data services when an EU-based architecture is required; the two pair naturally for European workloads.
Specific to using Aiven API API through Jentic.
What authentication does the Aiven API use?
The Aiven API supports a personal token (Authorization: aivenv1 {token}) and OAuth 2.0. Tokens are created from the Aiven console and scoped to a user; service tokens can be created for automation. When called through Jentic, the token is held in the Jentic vault and injected on each request.
Can I provision a managed PostgreSQL or Kafka cluster through the Aiven API?
Yes. POST /project/{project}/service with service_type set to pg, kafka, clickhouse, opensearch, mysql, redis, or another supported engine, plus plan and cloud. The service moves through REBUILDING → RUNNING; the response includes the service_uri once it is ready to accept connections.
How do I manage Kafka topics and ACLs?
The Service: Kafka endpoints expose topic creation, partition and retention configuration, ACL entries, quotas, and schema registry operations under /project/{project}/service/{service_name}/topic and /acl paths. They are the programmatic equivalent of the Kafka tab in the Aiven console.
What are the rate limits for the Aiven API?
Aiven applies per-token rate limits in the low hundreds of requests per minute, with separate ceilings for read and write paths. 429 responses include a Retry-After header; agents should back off and retry. Heavy bulk operations should use service-specific batch endpoints where available.
How do I provision an Aiven service through Jentic?
Search Jentic for 'create Aiven PostgreSQL service', load the POST /project/{project}/service operation, and execute it with project, service_type, plan, and cloud. Then poll GET /project/{project}/service/{service_name} until state=RUNNING to retrieve the service_uri.
Does the Aiven API support service maintenance and upgrades?
Yes. Service-level endpoints expose maintenance windows, allow triggering immediate upgrades, and surface upgrade pipeline state for blue/green-style migrations between major versions. Use these endpoints to script controlled major-version upgrades across a fleet of services.
/account/{account_id}/events
List recent events on an account