This surface is read-only. It answers questions about a graph's extensions data — RoboLedger and RoboInvestor records as they stand right now — and changes nothing. Every write is a named operation instead, so a query can never have a side effect and an operation is never a surprise.
Every query goes to one endpoint, scoped by its URL. graph_id is a path parameter and never a query argument, so a document cannot name a graph that disagrees with the path it was sent to.
curl -X POST "https://api.robosystems.ai/extensions/$GRAPH_ID/graphql" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "{ entity { id name } }"}'The schema is composed per deployment: ledger fields require RoboLedger and investor fields require RoboInvestor, and a disabled domain is absent from the schema rather than failing at runtime. This page is generated from the schema this deployment is serving, so what you see below is what you can ask for. For the mechanics — auth, pagination limits, the error vocabulary and the MCP tools that give an agent the same surface — see the GraphQL Reads guide.
Two HTTP operations serve this surface. Everything below them is a query you send to the first one.
/extensions/{graph_id}/graphql/extensions/{graph_id}/graphqlRoboLedger: the entity and its counterparties, the chart of accounts and balances, events and transactions, the fiscal calendar and close, reports and publishing. Requires RoboLedger on the deployment.
accountRollupsAccountRollupsCoA accounts grouped by reporting element with balances.
accountsAccountListPaginated Chart of Accounts listing.
accountTreeAccountTreeChart of Accounts as a recursive tree.
agentAgentFetch a single counterparty agent by id.
agents[Agent!]!List counterparty agents with optional filters.
blockedSourceGraphsBlockedSourceGraphListSource graphs barred from sharing reports into this graph.
chartTemplates[ChartTemplate!]!Shipped chart-of-accounts templates for initialize-chart-of-accounts.
closingBookStructuresClosingBookStructuresClosing book sidebar navigation (statements, schedules, rollups, etc.).
elementsElementListPaginated list of taxonomy elements.
entities[LedgerEntity!]!List entities for a graph, optionally filtered by source.
entityLedgerEntityReturn the parent ledger entity (company) for a graph.
eventBlockEventBlockFetch a single event block by id.
eventBlocks[EventBlock!]!List event blocks with optional filters.
fiscalCalendarFiscalCalendarCurrent fiscal calendar state — pointers, gap, closeable status.
journalEntriesLedgerJournalEntryListPaginated journal — entries with their line items, newest first.
mappedTrialBalanceMappedTrialBalanceTrial balance rolled up to reporting concepts via mapping associations.
mappingMappingDetailSingle mapping structure with all associations.
mappingCandidates[Element!]!The rs-gaap concepts a chart-of-accounts element may map to.
mappingCoverageMappingCoverageCoverage stats for a mapping.
mappingsStructureListList all active mapping structures.
openPayablesOpenBalanceAggregate!Graph-wide open AP — symmetric to openReceivables.
openPayablesByAgent[OpenBalanceByAgent!]!Per-counterparty open AP rows, ordered by absolute balance descending.
openReceivablesOpenBalanceAggregate!Graph-wide open AR — total + counterparty count + open invoice count.
openReceivablesByAgent[OpenBalanceByAgent!]!Per-counterparty open AR rows, ordered by absolute balance descending.
periodCloseStatusPeriodCloseStatusClose status for all schedules in a fiscal period.
periodDraftsPeriodDraftsAll draft entries for a fiscal period, ready for review before close.
publishListPublishListDetailSingle publish list with enriched members, or null.
publishListsPublishListListPaginated list of publish lists for this graph.
reportReportSingle report definition with structures + entity name.
reportDownloadUrlReportBundleDownloadPresigned download URL for a published Report's serialization bundle.
reportingTaxonomyTaxonomyThe locked US GAAP reporting taxonomy, or null.
reportPackageReportPackageRehydrate a Report as a package.
reportsReportListList all report definitions for this graph.
statementStatementRendered financial statement for a report + blocktype.
structuresStructureListList active structures.
summaryLedgerSummaryLedger counts + date range + connection metadata.
taxonomiesTaxonomyListList all active taxonomies, optionally filtered by type.
transactionLedgerTransactionDetailSingle transaction with all entries and line items.
transactionsLedgerTransactionListPaginated list of transactions.
trialBalanceTrialBalanceTrial balance for posted entries in a date range.
unmappedElements[UnmappedElement!]!CoA elements not yet mapped to the reporting taxonomy.
The block envelopes both products share: a rendered statement, schedule or rollforward, and the taxonomy blocks behind them. Always present, whichever extensions are enabled.
informationBlockInformationBlockFetch a single Information Block envelope by id.
informationBlocks[InformationBlock!]!List Information Blocks with optional blocktype + category filters.
taxonomyBlockTaxonomyBlockFetch a single Taxonomy Block envelope by id.
taxonomyBlocks[TaxonomyBlock!]!List Taxonomy Blocks with optional filters.
The shared public taxonomy library — taxonomies, elements, arcs, structures and traits. Browse it with the `library` graph id, or from a tenant graph to see its own taxonomies with public fallback.
libraryElementLibraryElementGet a single element by id or by qname ('fac:Assets', etc).
libraryElementArcs[LibraryElementArc!]!Return all mapping arcs where this element is source or target.
libraryElementClassifications[LibraryElementClassification!]!All traits assigned to this element, grouped by category.
libraryElementEquivalentsLibraryEquivalenceReturn the equivalence fan-out (FAC ↔ us-gaap collapse).
libraryElements[LibraryElement!]!List library elements with filters + pagination.
libraryElementTreeLibraryElementTreeNodeWalk presentation arcs down from an element.
libraryStructureLibraryStructureGet a single structure (extended link role) by id.
libraryStructures[LibraryStructure!]!List structures (extended link roles) — BS, IS, custom, etc.
libraryTaxonomies[LibraryTaxonomy!]!List taxonomies visible to this graph.
libraryTaxonomyLibraryTaxonomyGet a taxonomy by id or (standard, version).
libraryTaxonomyArcCountInt!Count of arcs contributed by a taxonomy.
libraryTaxonomyArcs[LibraryAssociation!]!List every arc contributed by a taxonomy (via its structures).
searchLibraryElements[LibraryElement!]!Substring search across qname, name, and standard label text.
RoboInvestor: portfolios, securities, positions and holdings, alongside the ledger on the same graph. Requires RoboInvestor on the deployment.
holdingsHoldingsListPortfolio positions grouped by entity.
portfolioBlockPortfolioBlockPortfolio-centric molecule: portfolio + active positions + securities + entities.
portfoliosPortfolioListPaginated list of portfolios.
positionPositionSingle enriched position by id.
positionsPositionListPaginated list of positions.
securitiesSecurityListPaginated list of securities.
securitySecuritySingle security by id.
The auth probe. Open no session and touch no domain — use it to tell an endpoint that is up from credentials that are not.
helloString!Auth probe: returns hello, {user.email} for a valid request.