Browse the api reference

REST API reference

The platform API: 136 operations across 34 groups — graphs, billing, auth, connections and the rest. Every call goes to https://api.robosystems.ai and authenticates with an API key from your account settings.

Looking for RoboLedger or RoboInvestor? Those live on the extensions surface, where the reads are GraphQL and the writes are named operations.

To run a call in the browser, https://api.robosystems.ai serves an interactive console over this same specification.

Generated from the OpenAPI specification the API is serving, version 1.16.3.

The REST and GraphQL API for RoboSystems — an open-source, AI-native platform for accounting, financial reporting and investment management. It powers RoboLedger and RoboInvestor.

Two surfaces

Platform — /v1/… — graphs, queries, schema, documents, search, memory, connections, billing and access. Reads are REST GETs; every write is a named operation at /operations/{name} returning an OperationEnvelope, accepting an Idempotency-Key, and streaming progress at /v1/operations/{id}/stream. → API reference

Extensions — /extensions/… — RoboLedger and RoboInvestor, scoped by graph_id in the URL. Reads are GraphQL at POST /extensions/{graph_id}/graphql and change nothing; writes are named operations at /extensions/{domain}/{graph_id}/operations/{name}; analytical views read the materialized graph. → Extensions reference · every GraphQL query

Authenticating

X-API-Key: rfs… on REST, GraphQL and per-graph MCP. Browser sessions use JWTs from POST /v1/auth/login. The graph-agnostic MCP endpoint /v1/mcp takes OAuth 2.1 bearer tokens only.

Connecting an AI client

Every graph is an MCP server at POST /v1/graphs/{graph_id}/mcp, and POST /v1/mcp serves OAuth clients that pick their graph at consent. → MCP guide

Clients

robosystems-client for Python, @robosystems/client for TypeScript. → Guides · Technical docs

Operations by group

Subgraphs

List and inspect subgraph databases

Query

Execute Cypher queries on the knowledge graph

Search

Full-text and semantic search on documents, narratives and disclosures

Memory

Recall, list, and inspect the graph's per-graph semantic memory store

Documents

List documents for search and analysis

Tables

Table metadata for the staging layer

Files

List stored data files for generic graphs

Credits

Manage credit-based usage and allocation

Usage

Monitor usage, metrics, and system performance

Graph Limits

Storage usage, operation limits, and tier configuration

Graph Audit

Every change made to a graph, from the REST API, MCP clients, and AI operators

Graph Health

Database health and performance metrics

Graph Info

Database metadata and statistics

Org Usage

Track organization-wide usage, limits, and analytics

Auth: SSO

Cross-app token exchange, and enterprise OIDC where enabled

Service Offerings

View available offers and pricing

Status

API status and monitoring