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, one entity's chart.
accountTreeAccountTreeOne entity's Chart 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.
closingBookStructuresClosingBookStructuresOne entity's closing book sidebar navigation (statements, schedules, rollups, etc.).
elementsElementListPaginated list of taxonomy elements.
entities[LedgerEntity!]!List entities for a graph, optionally filtered by source.
entityLedgerEntityOne entity of the graph's reporting group: the named one, else the group parent.
eventBlockEventBlockFetch a single event block by id.
eventBlocks[EventBlock!]!List one entity's event blocks with optional filters.
fiscalCalendarFiscalCalendarAn entity's fiscal calendar — pointers, gap, closeable status.
journalEntriesLedgerJournalEntryListPaginated journal — one entity's 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 the active mapping structures, each naming the entity whose chart it maps from.
openPayablesOpenBalanceAggregate!One entity's open AP — symmetric to openReceivables.
openPayablesByAgent[OpenBalanceByAgent!]!Per-counterparty open AP rows, ordered by absolute balance descending.
openReceivablesOpenBalanceAggregate!One entity's open AR — total + counterparty count + open invoice count.
openReceivablesByAgent[OpenBalanceByAgent!]!Per-counterparty open AR rows, ordered by absolute balance descending.
periodCloseStatusPeriodCloseStatusClose status for an entity's schedules in a fiscal period.
periodDraftsPeriodDraftsAn entity's 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 one entity's report definitions, newest first.
statementStatementRendered financial statement for a report + blocktype.
structuresStructureListList active structures.
summaryLedgerSummaryOne entity's ledger counts + date range, with the graph's connection metadata.
taxonomiesTaxonomyListList all active taxonomies, optionally filtered by type.
transactionLedgerTransactionDetailSingle transaction with all entries and line items.
transactionsLedgerTransactionListPaginated list of one entity's transactions.
trialBalanceTrialBalanceOne entity's trial 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.
informationBlockSummaries[InformationBlockSummary!]!List Information Blocks as identities and counts, one row per block.
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.
Fields this reference has not grouped yet.
accountRegisterAccountRegisterOne entity's posted lines on one account, oldest first, each with the balance it leaves.
agedPayablesAgedBalances!Payables aged at a date — symmetric to agedReceivables.
agedReceivablesAgedBalances!Receivables aged at a date: bucket totals, a row per customer, and each entity's tie-out to its receivables accounts.
allocationOverridesAllocationOverrideListEvery month a member's allocation override is set for, oldest first.
allocationShareAllocationShareThe outside owners' share of a member's result for one month.
bankAccountsBankAccountListThe group's bank and card accounts, with what writes to each.
classificationStatsClassificationStatsHow one month's bank lines were classified, per suggestion source.
dimensionsDimensionListThe graph's management dimension members (departments, classes, locations, projects), by axis then name, each with how many lines carry it.
dischargeCandidatesDischargeCandidatesThe open invoices or bills a payment or bank line may settle.
eventHandlerEventHandlerOne event handler, or null.
eventHandlersEventHandlerListThe graph's event handlers — the rules that turn a matching event into GL rows — highest priority first, active or not.
flowCandidates[FlowCandidate!]!The cash flow rows a line may be tagged with.
openItemsForAgent[OpenItem!]!One counterparty's open invoices or bills at a date, oldest first, each with its due date, age and bucket.
reconciliationsReconciliationListEvery reconciliation's standing at a period end, for one entity.
reportSharesReportShareListWhere this graph's reports have been shared: each recipient graph, when, by whom, how many facts it received, and whether the share was revoked.