Apache Druid Druid API

openapi: 3.1.0
info:
  title: Apache REST Druid API
  version: '1.0'
  description: Minimal OpenAPI for Apache Druid SQL and Data Management HTTP endpoints, covering SQL queries, asynchronous statement queries, and segment/datasource management via the indexer and coordinator.
servers:
- url: http://localhost:8888
  description: Druid Router (default)
tags:
- name: Druid
paths:
  /druid/v2/sql:
    post:
      summary: Submit a Druid SQL query
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Query results
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
      tags:
      - Druid
  /druid/v2/sql/{sqlQueryId}:
    delete:
      summary: Cancel a SQL query
      parameters:
      - name: sqlQueryId
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Cancellation accepted
      tags:
      - Druid
  /druid/v2/sql/statements:
    post:
      summary: Submit an asynchronous SQL statement
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Statement accepted
          content:
            application/json:
              schema:
                type: object
      tags:
      - Druid
  /druid/v2/sql/statements/{queryId}:
    get:
      summary: Get statement status
      parameters:
      - name: queryId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Statement status
          content:
            application/json:
              schema:
                type: object
      tags:
      - Druid
    delete:
      summary: Cancel an asynchronous statement
      parameters:
      - name: queryId
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Cancellation accepted
      tags:
      - Druid
  /druid/v2/sql/statements/{queryId}/results:
    get:
      summary: Fetch statement results
      parameters:
      - name: queryId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Results
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
      tags:
      - Druid
  /druid/indexer/v1/datasources/{datasource}:
    post:
      summary: Mark all segments of a datasource as used
      parameters:
      - name: datasource
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      tags:
      - Druid
    delete:
      summary: Mark all segments of a datasource as unused
      parameters:
      - name: datasource
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      tags:
      - Druid
  /druid/indexer/v1/datasources/{datasource}/markUsed:
    post:
      summary: Mark segments matching criteria as used
      parameters:
      - name: datasource
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      tags:
      - Druid
  /druid/indexer/v1/datasources/{datasource}/markUnused:
    post:
      summary: Mark segments matching criteria as unused
      parameters:
      - name: datasource
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      tags:
      - Druid
  /druid/indexer/v1/datasources/{datasource}/segments/{segmentId}:
    post:
      summary: Mark a specific segment as used
      parameters:
      - name: datasource
        in: path
        required: true
        schema:
          type: string
      - name: segmentId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      tags:
      - Druid
    delete:
      summary: Mark a specific segment as unused
      parameters:
      - name: datasource
        in: path
        required: true
        schema:
          type: string
      - name: segmentId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      tags:
      - Druid
  /druid/coordinator/v1/datasources/{datasource}/intervals/{interval}:
    delete:
      summary: Mark segments in an interval as unused
      parameters:
      - name: datasource
        in: path
        required: true
        schema:
          type: string
      - name: interval
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      tags:
      - Druid
x-generated-from: https://druid.apache.org/docs/latest/api-reference/
x-generated-by: claude-crawl-2026-05-08