RoboLedger: Setup

Initialize Chart of Accounts

Create the graph's chart of accounts from a shipped template — the fresh-company path to native books. Use when the graph has NO chart (a QuickBooks-synced tenant never needs this: its chart arrives with the sync and stays after a sever) and before connecting a bank feed, which needs a chart to resolve against. Templates: saas (subscription software), services (professional services), product (inventory and COGS) — the chartTemplates GraphQL field lists them with names and account counts. Creates the chart, its coa_mapping structure and the template's CoA → rs-gaap mapping associations in one transaction, with the equity rows mapped by the entity's legal form (entity_type, defaulting to the entity's). Each entity of the group keeps its own chart: entity_id names a subsidiary, omitted means the group parent. One-time per entity: 409 once that entity has a chart — a chart is never replaced. Customize afterwards with update-taxonomy-block; accounts that carry activity are never deleted.

Idempotency: supply an Idempotency-Key header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.

post/extensions/roboledger/{graph_id}/operations/initialize-chart-of-accounts

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/extensions/roboledger/{graph_id}/operations/initialize-chart-of-accounts
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Headers

Idempotency-Keystring nullable

Request body

entity_idstring nullable

The entity to give a chart to, by id. Omit for the group parent. A sibling already having one is no bar.

template'saas' | 'services' | 'product' | 'consolidation' required

Template key: saas (subscription software — deferred revenue, cost of revenue, R&D / S&M / G&A), services (professional services — no inventory, no COGS), product (inventory and cost of goods sold, direct + wholesale + subscription revenue), consolidation (a group's consolidation entity: the eliminated investment, intercompany and subsidiary-equity rows, noncontrolling interest and its share of income — the adjustments column, never an operating company's chart).

entity_typestring nullable

Legal form for the equity mapping: corporation, llc or partnership. Defaults to the graph's primary entity, then to corporation.

namestring nullable

Chart display name. Defaults to 'Chart of Accounts'.

Example request

{
  "template": "saas"
}

Response

Successful Response

operationstring required

Kebab-case operation name

operationIdstring required

op_-prefixed ULID for audit and SSE correlation

status'completed' | 'pending' | 'failed' required

Operation lifecycle state

atstring required

ISO-8601 UTC timestamp

createdBystring nullable

User ID that initiated the operation

idempotentReplayboolean

True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.

Changes

No recorded changes to this operation across all 1 revision of this API.