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/