docsmint-com Graph API
GraphRAG entity and relationship queries (AGE)
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/docsmint-com:docsmint-com-graph-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: DocsMint Graph API
description: Self-hosted AI-native knowledge workspace and installable PWA with hybrid search, GraphRAG, REST, SDK, CLI, and MCP access for people and AI agents.
version: 2.0.4
contact:
name: HiAi-gg
url: https://github.com/HiAi-gg/docsmint
license:
name: Apache-2.0
url: https://www.apache.org/licenses/LICENSE-2.0
tags:
- name: Graph
description: GraphRAG entity and relationship queries (AGE)
paths:
/api/graph/entities:
get:
operationId: getApiGraphEntities
tags:
- Graph
summary: List entities linked to a document
description: Requires read access to the seed document in the active workspace or effective category. Returns entities from its active graph generation; graph unavailability or disabled graph search returns an empty entities array.
security:
- SessionAuth: []
- BearerAuth: []
parameters:
- in: query
name: docId
required: true
description: Readable seed document ID.
schema:
type: string
minLength: 1
responses:
'200':
description: Seed entity context.
content:
application/json:
schema:
type: object
required:
- entities
properties:
entities:
type: array
items:
type: object
required:
- name
- type
properties:
name:
type: string
type:
type: string
'400':
description: Invalid request parameters or body.
'401':
description: Authentication required.
'403':
description: Read access required.
'404':
description: Document not found in the active scope.
'429':
description: Search rate limit exceeded.
/api/graph/related/{docId}:
get:
operationId: getApiGraphRelatedByDocId
tags:
- Graph
summary: List related documents via graph traversal
description: Requires read access to the seed. Returns current-generation graph neighbors within the active workspace or effective category, ordered by hop distance then document ID. The limit applies after authorization and generation filtering. Disabled or unavailable graph search returns an empty related array.
security:
- SessionAuth: []
- BearerAuth: []
parameters:
- in: path
name: docId
required: true
description: Readable seed document ID.
schema:
type: string
minLength: 1
- in: query
name: limit
required: false
description: Maximum authorized related documents to return.
schema:
type: integer
minimum: 1
maximum: 100
default: 20
responses:
'200':
description: Authorized graph neighbors.
content:
application/json:
schema:
type: object
required:
- related
properties:
related:
type: array
maxItems: 100
items:
type: object
required:
- docId
- relationType
- hopDistance
properties:
docId:
type: string
relationType:
type: string
hopDistance:
type: integer
minimum: 1
'400':
description: Invalid request parameters or body.
'401':
description: Authentication required.
'403':
description: Read access required.
'404':
description: Seed document not found in the active scope.
'429':
description: Search rate limit exceeded.
/api/graph/search:
post:
operationId: postApiGraphSearch
tags:
- Graph
summary: Graph-aware RAG retrieval for agents
description: Every seed requires read access in the active workspace or effective category before traversal. Non-blank query text filters authorized current-generation neighbors using exact-title and English or language-neutral full-text matching. Exact titles rank first, followed by lexical score and document ID. No model call is made. An omitted or blank query returns unfiltered authorized graph context ordered by hop distance then document ID. Entities always describe the seed documents and are not query-filtered. Disabled or unavailable graph search returns empty entities and relatedDocs arrays.
security:
- SessionAuth: []
- BearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- docIds
properties:
query:
type: string
maxLength: 2000
description: Optional lexical query for related documents; blank or omitted leaves graph context unfiltered.
docIds:
type: array
minItems: 1
maxItems: 50
items:
type: string
minLength: 1
description: Readable seed document IDs; one inaccessible seed rejects the request.
maxResults:
type: integer
minimum: 1
maximum: 100
description: Optional cap on relatedDocs after authorization, query filtering, and ranking. Does not limit seed entities. Omit to return all matches produced by the bounded graph traversal.
responses:
'200':
description: Seed entities and authorized related document summaries.
content:
application/json:
schema:
type: object
required:
- entities
- relatedDocs
properties:
query:
type: string
entities:
type: array
items:
type: object
required:
- name
- type
properties:
name:
type: string
type:
type: string
relatedDocs:
type: array
items:
type: object
required:
- docId
- relationType
- hopDistance
- title
- snippet
properties:
docId:
type: string
relationType:
type: string
hopDistance:
type: integer
minimum: 1
title:
type: string
snippet:
type: string
maxLength: 200
'400':
description: Invalid request parameters or body.
'401':
description: Authentication required.
'403':
description: Read access required.
'404':
description: One or more seed documents were not found in the active scope.
'429':
description: Search rate limit exceeded.
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: hiai_docs_*
description: Global or category-scoped DocsMint API key. The operator key is also accepted as a bearer token on operator-capable routes.
SessionAuth:
type: apiKey
in: cookie
name: better-auth.session_token
description: Better Auth browser session. Secure deployments may use the __Secure- prefixed cookie name.
OperatorApiKey:
type: apiKey
in: header
name: x-api-key
description: Static HIAI_DOCS_API_KEY for /api/admin operator endpoints.