docsmint-com Categories API
Category management for folders and documents
Category management for folders and documents
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/docsmint-com:docsmint-com-categories-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: DocsMint Categories 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: Categories
description: Category management for folders and documents
paths:
/api/categories:
get:
operationId: getApiCategories
responses:
'200': {}
security:
- SessionAuth: []
- BearerAuth: []
tags:
- Categories
summary: Get api categories
x-summary-source: derived
post:
operationId: postApiCategories
responses:
'200': {}
'409':
$ref: '#/components/responses/AccountPurgeFenced'
security:
- SessionAuth: []
- BearerAuth: []
tags:
- Categories
summary: Post api categories
x-summary-source: derived
/api/categories/{id}:
patch:
operationId: patchApiCategoriesById
parameters:
- schema:
type: string
in: path
name: id
required: true
responses:
'200': {}
'409':
$ref: '#/components/responses/AccountPurgeFenced'
security:
- SessionAuth: []
- BearerAuth: []
tags:
- Categories
summary: Patch api categories by id
x-summary-source: derived
delete:
operationId: deleteApiCategoriesById
parameters:
- schema:
type: string
in: path
name: id
required: true
responses:
'200': {}
'409':
$ref: '#/components/responses/AccountPurgeFenced'
security:
- SessionAuth: []
- BearerAuth: []
tags:
- Categories
summary: Delete api categories by id
x-summary-source: derived
/api/categories/{id}/keys:
post:
operationId: postApiCategoriesByIdKeys
parameters:
- schema:
type: string
in: path
name: id
required: true
responses:
'200': {}
security:
- SessionAuth: []
tags:
- Categories
summary: Post api categories by id keys
x-summary-source: derived
components:
schemas:
AccountPurgeFencedError:
type: object
required:
- error
- code
additionalProperties: false
properties:
error:
type: string
enum:
- Account deletion is in progress
code:
type: string
enum:
- ACCOUNT_PURGE_FENCED
responses:
AccountPurgeFenced:
description: The account deletion fence is active; no mutation was admitted.
content:
application/json:
schema:
$ref: '#/components/schemas/AccountPurgeFencedError'
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.