Cloudflare Configurations API

Create, list, update, and delete Hyperdrive configurations that connect Workers to databases.

Documentation 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 /accounts/{account_id}/hyperdrive/configs List Hyperdrive configurations · Cloudflare List Hyperdrive Configurations #

Ask an LLM

“What Hyperdrive database connections have I set up in my account?”

“How do I see all my Hyperdrive configs at once?”

Tell an agent

List all Hyperdrive configurations in account {account}.

Show me every Hyperdrive setup on account {account}.

POST /accounts/{account_id}/hyperdrive/configs Create a Hyperdrive configuration for a database · Cloudflare Create Hyperdrive Configuration #

Ask an LLM

“How do I put Hyperdrive in front of my existing Postgres database?”

“Can I configure caching settings when I first set up a Hyperdrive connection?”

Tell an agent

Create a Hyperdrive configuration named {name} in account {account} connecting to origin {origin}.

Set up new Hyperdrive config {name} for origin {origin} in account {account} with caching {caching}.

GET /accounts/{account_id}/hyperdrive/configs/{config_id} Get a Hyperdrive configuration's details · Cloudflare Get Hyperdrive Configuration #

Ask an LLM

“How can I check the origin and caching settings of one Hyperdrive config?”

“Which database host is a specific Hyperdrive configuration pointing at?”

Tell an agent

Show Hyperdrive configuration {config} in account {account}.

Get the connection details of Hyperdrive config {config} in account {account}.

PUT /accounts/{account_id}/hyperdrive/configs/{config_id} Update a Hyperdrive configuration · Cloudflare Update Hyperdrive Configuration #

Ask an LLM

“How do I point an existing Hyperdrive config at a new database origin?”

“Can I change caching on a Hyperdrive configuration after it's been created?”

Tell an agent

Update Hyperdrive config {config} in account {account} to name {name} and origin {origin}.

Change caching on existing Hyperdrive config {config} in account {account} to {caching}, keeping name {name} and origin {origin}.

DELETE /accounts/{account_id}/hyperdrive/configs/{config_id} Delete a Hyperdrive configuration · Cloudflare Delete Hyperdrive Configuration #

Ask an LLM

“How do I remove a Hyperdrive configuration I'm not using anymore?”

“Can I tear down one Hyperdrive connection without affecting the others?”

Tell an agent destructive · confirm first

Delete Hyperdrive configuration {config} from account {account}.

Remove the unused Hyperdrive config {config} in account {account}.

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/cloudflare:cloudflare-configurations-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

openapi: 3.2.0
info:
  title: Cloudflare Hyperdrive Configurations API
  description: Cloudflare Hyperdrive accelerates access to existing databases from Cloudflare Workers by providing connection pooling and query caching at the edge. The API allows developers to create and manage Hyperdrive configurations that connect to PostgreSQL and other databases.
  version: '4.0'
  contact:
    name: Cloudflare Support
    url: https://support.cloudflare.com/
  termsOfService: https://www.cloudflare.com/terms/
servers:
- url: https://api.cloudflare.com/client/v4
  description: Cloudflare API v4 Production Server
security:
- bearerAuth: []
tags:
- name: Configurations
  description: Create, list, update, and delete Hyperdrive configurations that connect Workers to databases.
paths:
  /accounts/{account_id}/hyperdrive/configs:
    get:
      operationId: listHyperdriveConfigs
      summary: Cloudflare List Hyperdrive Configurations
      description: Returns all Hyperdrive configurations for the account.
      tags:
      - Configurations
      parameters:
      - $ref: '#/components/parameters/AccountId'
      responses:
        '200':
          description: List of Hyperdrive configurations.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigListResponse'
              examples:
                Listhyperdriveconfigs200Example:
                  summary: Default listHyperdriveConfigs 200 response
                  x-microcks-default: true
                  value:
                    result:
                    - id: abc123
                      name: Example Title
                      origin: {}
                      caching: {}
                    success: true
        '401':
          description: Unauthorized.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createHyperdriveConfig
      summary: Cloudflare Create Hyperdrive Configuration
      description: Create a new Hyperdrive configuration with database origin connection details and caching settings.
      tags:
      - Configurations
      parameters:
      - $ref: '#/components/parameters/AccountId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfigInput'
            examples:
              CreatehyperdriveconfigRequestExample:
                summary: Default createHyperdriveConfig request
                x-microcks-default: true
                value:
                  name: Example Title
                  origin:
                    scheme: example_value
                    host: example_value
                    port: 10
                    database: example_value
                    user: example_value
                    password: example_value
                  caching:
                    disabled: true
                    max_age: 10
                    stale_while_revalidate: 10
      responses:
        '200':
          description: Configuration created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigResponse'
              examples:
                Createhyperdriveconfig200Example:
                  summary: Default createHyperdriveConfig 200 response
                  x-microcks-default: true
                  value:
                    result:
                      id: abc123
                      name: Example Title
                      origin:
                        scheme: example_value
                        host: example_value
                        port: 10
                        database: example_value
                        user: example_value
                      caching:
                        disabled: true
                        max_age: 10
                        stale_while_revalidate: 10
                    success: true
                    errors:
                    - {}
                    messages:
                    - {}
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /accounts/{account_id}/hyperdrive/configs/{config_id}:
    get:
      operationId: getHyperdriveConfig
      summary: Cloudflare Get Hyperdrive Configuration
      description: Retrieve details of a specific Hyperdrive configuration.
      tags:
      - Configurations
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/ConfigId'
      responses:
        '200':
          description: Configuration details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigResponse'
              examples:
                Gethyperdriveconfig200Example:
                  summary: Default getHyperdriveConfig 200 response
                  x-microcks-default: true
                  value:
                    result:
                      id: abc123
                      name: Example Title
                      origin:
                        scheme: example_value
                        host: example_value
                        port: 10
                        database: example_value
                        user: example_value
                      caching:
                        disabled: true
                        max_age: 10
                        stale_while_revalidate: 10
                    success: true
                    errors:
                    - {}
                    messages:
                    - {}
        '401':
          description: Unauthorized.
        '404':
          description: Configuration not found.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateHyperdriveConfig
      summary: Cloudflare Update Hyperdrive Configuration
      description: Update a Hyperdrive configuration's connection details and settings.
      tags:
      - Configurations
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/ConfigId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfigInput'
            examples:
              UpdatehyperdriveconfigRequestExample:
                summary: Default updateHyperdriveConfig request
                x-microcks-default: true
                value:
                  name: Example Title
                  origin:
                    scheme: example_value
                    host: example_value
                    port: 10
                    database: example_value
                    user: example_value
                    password: example_value
                  caching:
                    disabled: true
                    max_age: 10
                    stale_while_revalidate: 10
      responses:
        '200':
          description: Configuration updated.
        '401':
          description: Unauthorized.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteHyperdriveConfig
      summary: Cloudflare Delete Hyperdrive Configuration
      description: Delete a Hyperdrive configuration.
      tags:
      - Configurations
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/ConfigId'
      responses:
        '200':
          description: Configuration deleted.
        '401':
          description: Unauthorized.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    AccountId:
      name: account_id
      in: path
      required: true
      description: The unique identifier of the Cloudflare account.
      schema:
        type: string
    ConfigId:
      name: config_id
      in: path
      required: true
      description: The unique identifier of the Hyperdrive configuration.
      schema:
        type: string
  schemas:
    HyperdriveConfig:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier.
          example: abc123
        name:
          type: string
          description: The name of the configuration.
          example: Example Title
        origin:
          type: object
          properties:
            scheme:
              type: string
              description: The database protocol.
            host:
              type: string
              description: The database host.
            port:
              type: integer
              description: The database port.
            database:
              type: string
              description: The database name.
            user:
              type: string
              description: The database user.
          example: example_value
        caching:
          type: object
          properties:
            disabled:
              type: boolean
              description: Whether caching is disabled.
            max_age:
              type: integer
              description: Maximum cache age in seconds.
            stale_while_revalidate:
              type: integer
              description: Stale-while-revalidate window in seconds.
          example: example_value
    ConfigInput:
      type: object
      required:
      - name
      - origin
      properties:
        name:
          type: string
          description: Name for the configuration.
          example: Example Title
        origin:
          type: object
          required:
          - scheme
          - host
          - port
          - database
          - user
          - password
          properties:
            scheme:
              type: string
              description: Database protocol.
            host:
              type: string
              description: Database host.
            port:
              type: integer
              description: Database port.
            database:
              type: string
              description: Database name.
            user:
              type: string
              description: Database user.
            password:
              type: string
              description: Database password.
          example: example_value
        caching:
          type: object
          properties:
            disabled:
              type: boolean
            max_age:
              type: integer
            stale_while_revalidate:
              type: integer
          example: example_value
    ConfigResponse:
      type: object
      properties:
        result:
          $ref: '#/components/schemas/HyperdriveConfig'
        success:
          type: boolean
          example: true
        errors:
          type: array
          items:
            type: object
          example: []
        messages:
          type: array
          items:
            type: object
          example: []
    ConfigListResponse:
      type: object
      properties:
        result:
          type: array
          items:
            $ref: '#/components/schemas/HyperdriveConfig'
          example: []
        success:
          type: boolean
          example: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token with Hyperdrive permissions.
externalDocs:
  description: Cloudflare Hyperdrive API Documentation
  url: https://developers.cloudflare.com/api/resources/hyperdrive/

Cloudflare Configurations API

Operations 5

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification