Skip to content
Naburis Docs

API Reference

This document covers the primary API surface. All endpoints accept and return JSON unless noted otherwise.

Common Headers

Section titled “Common Headers”
  • X-Tenant-ID
  • X-Workspace-ID
  • X-Context-ID
  • Authorization: Bearer <token> (required for all authenticated endpoints)

Health

Section titled “Health”

Every service exposes GET /health and returns JSON with dependency status.

Gateway

Section titled “Gateway”

SPARQL Query

Section titled “SPARQL Query”
POST /sparql
Content-Type: application/sparql-query
Accept: application/sparql-results+json

SPARQL Update

Section titled “SPARQL Update”
POST /sparql/update
Content-Type: application/sparql-update

GQL (subset)

Section titled “GQL (subset)”
POST /gql
Content-Type: application/json

Request body:

{
  "start": "urn:ex:Alice",
  "predicates": ["urn:ex:knows"],
  "direction": "out",
  "depth": 1,
  "limit": 25
}

Statement Service

Section titled “Statement Service”

Create Statement

Section titled “Create Statement”
POST /statements
Content-Type: application/json
{
  "subject": "urn:ex:Alice",
  "predicate": "urn:ex:knows",
  "object": "urn:ex:Bob",
  "objectType": "iri",
  "contextId": "urn:tenant:t1:ws:w1:graph:core",
  "metadata": {"confidence": 0.92}
}

Batch Create

Section titled “Batch Create”
POST /statements/batch

Get Statement

Section titled “Get Statement”
GET /statements/{id}

Stats

Section titled “Stats”
GET /statements/stats

Shapes Service

Section titled “Shapes Service”

List Shapes

Section titled “List Shapes”
GET /shapes

Create Shape

Section titled “Create Shape”
POST /shapes
Content-Type: application/json
{
  "name": "PersonShape",
  "turtle": "@prefix sh: <http://www.w3.org/ns/shacl#> ..."
}

UI Schema

Section titled “UI Schema”
GET /shapes/{id}/ui

Validate

Section titled “Validate”
POST /validate
{
  "shapeId": "urn:keystone:shape:...",
  "limit": 5000
}

Projection Service

Section titled “Projection Service”

Query Graph

Section titled “Query Graph”
POST /gql

Response:

{
  "nodes": [{"nodeId":"urn:ex:Alice"}],
  "edges": [{"edgeId":"urn:keystone:stmt:...","from":"...","to":"..."}]
}

Index Service

Section titled “Index Service”
Section titled “Keyword Search”
GET /search?q=climate&limit=20
Section titled “Vector Search”
POST /search/vector
{
  "vector": [0.01, 0.02, 0.03],
  "limit": 10
}

Catalog Service

Section titled “Catalog Service”
POST /catalog/datasets
GET  /catalog/datasets
GET  /catalog/datasets/{id}
POST /catalog/distributions
GET  /catalog/distributions/{id}

Workflow Service

Section titled “Workflow Service”
POST /workflow/artifacts
GET  /workflow/{id}/status
POST /workflow/{id}/submit
POST /workflow/{id}/publish
POST /workflow/{id}/deprecate
POST /workflow/{id}/archive
POST /workflow/{id}/reject

Ingestion Service

Section titled “Ingestion Service”
POST /ingestions/statements
GET  /ingestions/{id}

Ontology Service

Section titled “Ontology Service”
POST /ontologies
GET  /ontologies
POST /ontologies/score

Tutor Service

Section titled “Tutor Service”
POST /tutor/answer
POST /tutor/summarize

Request Flow (Example)

Section titled “Request Flow (Example)”