openapi: 3.2.0
info:
  title: SPARQL Protocol Sparql Update API
  description: OpenAPI specification for the SPARQL 1.1 Protocol, a W3C Recommendation that defines HTTP operations for executing SPARQL queries and updates against an RDF dataset. The protocol supports both query operations (SELECT, ASK, CONSTRUCT, DESCRIBE) and update operations (INSERT, DELETE, LOAD, CLEAR) via standard HTTP methods.
  version: '1.1'
  contact:
    name: W3C SPARQL Working Group
    url: https://www.w3.org/2009/sparql/wiki/Main_Page
  license:
    name: W3C Software and Document License
    url: https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
servers:
- url: '{sparqlEndpoint}'
  description: SPARQL Protocol Endpoint
  variables:
    sparqlEndpoint:
      default: https://dbpedia.org/sparql
      description: The URL of the SPARQL endpoint
tags:
- name: Sparql Update
paths:
  /sparql-update:
    post:
      operationId: sparqlUpdate
      summary: Execute SPARQL Update
      description: Executes a SPARQL 1.1 Update operation against the RDF dataset. Supports INSERT DATA, DELETE DATA, INSERT/DELETE (with WHERE), LOAD, CLEAR, CREATE, DROP, COPY, MOVE, and ADD operations.
      parameters:
      - name: using-graph-uri
        in: query
        description: Default graph URI for the update operation. Multiple values allowed to specify the dataset for the WHERE clause.
        schema:
          type: string
        style: form
        explode: true
      - name: using-named-graph-uri
        in: query
        description: Named graph URI for the update operation. Multiple values allowed to specify named graphs for the WHERE clause.
        schema:
          type: string
        style: form
        explode: true
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - update
              properties:
                update:
                  type: string
                  description: The SPARQL Update string
                using-graph-uri:
                  type: string
                  description: Default graph URI for the update
                using-named-graph-uri:
                  type: string
                  description: Named graph URI for the update
          application/sparql-update:
            schema:
              type: string
              description: The SPARQL Update string sent directly as the request body with Content-Type application/sparql-update.
      responses:
        '200':
          description: Update executed successfully
        '204':
          description: Update executed successfully (no content)
        '400':
          $ref: '#/components/responses/MalformedQuery'
        '500':
          $ref: '#/components/responses/QueryExecutionFailure'
      tags:
      - Sparql Update
components:
  responses:
    MalformedQuery:
      description: The SPARQL query or update string is syntactically invalid or malformed.
      content:
        text/plain:
          schema:
            type: string
            description: Error message describing the syntax issue
    QueryExecutionFailure:
      description: The server encountered an error while executing the query or update operation.
      content:
        text/plain:
          schema:
            type: string
            description: Error message describing the execution failure
externalDocs:
  description: SPARQL 1.1 Protocol - W3C Recommendation
  url: https://www.w3.org/TR/sparql11-protocol/