Aiven API

Name: Aiven API API
Brand: Aiven API
Availability: InStock

✓ Official Vendor SpecCloud InfrastructureComputebearer, oauth2445 EndpointsREST

For Agents

Provision and operate managed PostgreSQL, Kafka, ClickHouse, OpenSearch, and other open-source data services across major clouds via Aiven.

Quickstart

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.

Capabilities

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

Start building with Aiven API API

Explore with Jentic

View OpenAPI Document

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.

Use Cases

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.

Key Endpoints

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

GET

/account

List Aiven accounts

GET

/account/{account_id}

Retrieve a specific account

GET

/account/{account_id}/payment_methods

List payment methods on an account

GET

/account/{account_id}/billing-group

List billing groups on an account

GET

/account/{account_id}/authentication

List authentication methods on an account

GET

/account/{account_id}/events

List recent events on an account

GET

/account

List Aiven accounts

GET

/account/{account_id}

Retrieve a specific account

GET

/account/{account_id}/payment_methods

List payment methods on an account

GET

/account/{account_id}/billing-group

List billing groups on an account

GET

/account/{account_id}/authentication

List authentication methods on an account

Why though Jentic?

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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

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).

Alternative

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.

Complementary

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.

FAQs

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.