Miriel

Miriel Documents API

The Documents API from Miriel — 8 operation(s) for documents.

Documentation GitHub OpenAPI

Operations 8

POST /api/v2/update_document Update a document's metadata or access #

POST /api/v2/get_document_by_id Get a document by ID #

POST /api/v2/get_all_documents List documents #

POST /api/v2/get_document_count Count documents #

POST /api/v2/remove_document Remove a document #

POST /api/v2/remove_all_documents Remove all documents #

POST /api/v2/remove_resource Remove a resource #

POST /api/v2/set_document_access Set document access grants #

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/miriel-documents-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Miriel Context Engine Documents API
  version: v2
  description: Miriel is the context engine and platform for AI-native development. The API lets applications and agents learn from any data source and query relevant context in real time, with LLM-, vector-, and graph-based retrieval, per-token permissions (grant IDs), and encryption. This description is a faithful derivation of the official TypeScript SDK (@miriel/miriel v0.1.0); Miriel does not publish a machine-readable OpenAPI document at a public URL.
  contact:
    name: Miriel
    url: https://miriel.ai
  x-derived-from: npm @miriel/miriel v0.1.0 (dist type definitions + compiled client)
servers:
- url: https://api.prod.miriel.ai
  description: Production
security:
- accessToken: []
tags:
- name: Documents
paths:
  /api/v2/update_document:
    post:
      operationId: updateDocument
      summary: Update a document's metadata or access
      tags:
      - Documents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document_id
              properties:
                document_id:
                  type: string
                user_id:
                  type: string
                metadata: {}
                discoverable:
                  type: boolean
                grant_ids:
                  type: array
                  items:
                    type: string
                chunk_size:
                  type: integer
      responses:
        '200':
          description: Updated document
  /api/v2/get_document_by_id:
    post:
      operationId: getDocumentById
      summary: Get a document by ID
      tags:
      - Documents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document_id
              properties:
                document_id:
                  type: string
                user_id:
                  type: string
      responses:
        '200':
          description: Document
  /api/v2/get_all_documents:
    post:
      operationId: getAllDocuments
      summary: List documents
      tags:
      - Documents
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: string
                project: {}
                metadata_query: {}
      responses:
        '200':
          description: Documents
  /api/v2/get_document_count:
    post:
      operationId: getDocumentCount
      summary: Count documents
      tags:
      - Documents
      responses:
        '200':
          description: Document count
  /api/v2/remove_document:
    post:
      operationId: removeDocument
      summary: Remove a document
      tags:
      - Documents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document_id
              properties:
                document_id:
                  type: string
                user_id:
                  type: string
      responses:
        '200':
          description: Removed
  /api/v2/remove_all_documents:
    post:
      operationId: removeAllDocuments
      summary: Remove all documents
      tags:
      - Documents
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: string
      responses:
        '200':
          description: Removed
  /api/v2/remove_resource:
    post:
      operationId: removeResource
      summary: Remove a resource
      tags:
      - Documents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - resource_id
              properties:
                resource_id:
                  type: string
                user_id:
                  type: string
      responses:
        '200':
          description: Removed
  /api/v2/set_document_access:
    post:
      operationId: setDocumentAccess
      summary: Set document access grants
      tags:
      - Documents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - user_id
              - document_id
              - grant_ids
              properties:
                user_id:
                  type: string
                document_id:
                  type: string
                grant_ids:
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: Access updated
components:
  securitySchemes:
    accessToken:
      type: apiKey
      in: header
      name: x-access-token
      description: API key issued from the Miriel dashboard, sent in the x-access-token header.