Confluent

Confluent Agents (sql/v1) API

[![Preview](https://img.shields.io/badge/Lifecycle%20Stage-Preview-%2300afba)](#section/Versioning/API-Lifecycle-Policy) `Agent` models an AI agent that uses a specified model, prompt, and set of tools to autonomously perform tasks. The API allows you to create your agents. ## The Agents Model

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /sql/v1/organizations/{organization_id}/environments/{environment_id}/agents List Flink SQL agents in an environment · List all agents #
Ask an LLM
“Which AI agents are defined in my Flink SQL environment?”
“Can I page through all agents in an environment?”
Tell an agent
List agents in environment {environment_id} of organization {organization_id}.
Show all agents in environment {environment_id}, org {organization_id}, {page_size} per page.
POST /sql/v1/organizations/{organization_id}/environments/{environment_id}/databases/{kafka_cluster_id}/agents Create a Flink SQL agent · Create an Agent #
Ask an LLM
“How do I create an AI agent in a Confluent Flink SQL database?”
“What does an agent spec need, like model and prompt?”
Tell an agent
Create agent {name} in database {kafka_cluster_id}, environment {environment_id}, org {organization_id} with spec {spec}.
Define a new agent called {name} on Kafka cluster {kafka_cluster_id} in environment {environment_id}, org {organization_id}.
GET /sql/v1/organizations/{organization_id}/environments/{environment_id}/databases/{kafka_cluster_id}/agents/{agent_name} Get a Flink SQL agent by name · Read an Agent #
Ask an LLM
“What model and prompt is a specific agent configured with?”
“Can I read one agent's definition by its name?”
Tell an agent
Get agent {agent_name} in database {kafka_cluster_id}, environment {environment_id}, org {organization_id}.
Show the definition of agent {agent_name} on cluster {kafka_cluster_id} (env {environment_id}, org {organization_id}).
PUT /sql/v1/organizations/{organization_id}/environments/{environment_id}/databases/{kafka_cluster_id}/agents/{agent_name} Alter a Flink SQL agent's prompt or model · Alter an Agent #
Ask an LLM
“Can I change an agent's prompt, model or description after it is created?”
“Which agent fields are mutable?”
Tell an agent
Alter agent {agent_name} in database {kafka_cluster_id}, env {environment_id}, org {organization_id} to use spec {spec}.
Update the prompt and model of agent {agent_name} on cluster {kafka_cluster_id}, env {environment_id}, org {organization_id}.
DELETE /sql/v1/organizations/{organization_id}/environments/{environment_id}/databases/{kafka_cluster_id}/agents/{agent_name} Delete a Flink SQL agent · Delete an Agent #
Ask an LLM
“How do I remove an agent I no longer need from a Flink database?”
“Can agents be deleted by name?”
Tell an agent destructive · confirm first
Delete agent {agent_name} from database {kafka_cluster_id}, env {environment_id}, org {organization_id}.
Remove the agent named {agent_name} on cluster {kafka_cluster_id} in env {environment_id}, org {organization_id}.

Documentation

📖
APIReference
https://docs.confluent.io/cloud/current/api.html
📖
APIReference
https://api.telemetry.confluent.cloud/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/openapi/confluent-agents-sql-v1-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/json-schema/confluent-sql-v1-agent-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/json-schema/confluent-sql-v1-agent-list-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/confluent:confluent-agents-sql-v1-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

confluent-agents-sql-v1-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Confluent Agents (sql/v1) API
  version: ''
  x-api-id: 46234552-5833-42eb-ba0f-883ad3f70d2b
  x-audience: external-public
  x-logo:
    url: https://assets.confluent.io/m/1661ef5e4ff82d3d/
  description: 'Operations tagged Agents (sql/v1) across 2 of this provider''s published API definitions: confluent-cloud-openapi.yaml, confluent-cloud-full.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.confluent.cloud
  description: Confluent Cloud API
tags:


# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/openapi/confluent-agents-sql-v1-api-openapi.yml