Regenerate Report

post/extensions/roboledger/{graph_id}/operations/regenerate-report

Re-runs fact generation for an existing Report against the latest ledger state. Pass period_start/period_end/periods only if you want to change the reporting window.

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.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`graph_id`required	string	Graph Id

Header parameters

Name	Type	Description
`Idempotency-Key`optional	string	Idempotency-Key

Request body

Required, application/json.

Field Type Description

period_startoptional

string (date)

New current-period start. Optional — omit to keep the existing window.

period_endoptional

string (date)

New current-period end. Optional — omit to keep the existing window.

periodsoptional

PeriodSpec[]

New explicit period columns. Overrides `period_start`/`period_end` when supplied.

PeriodSpec fields

Field	Type	Description
`start`required	string (date)	Period start date (inclusive). Window the column rolls up.
`end`required	string (date)	Period end date (inclusive). Window the column rolls up.
`label`required	string	Column header label (e.g. 'FY2025 Q3', '2024', 'YTD').

report_idrequired

string

The Report to regenerate.

Example request

curl

curl -X POST "https://api.robosystems.ai/extensions/roboledger/{graph_id}/operations/regenerate-report" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Idempotency-Key: <Idempotency-Key>" \
  -H "Content-Type: application/json" \
  -d '{
  "report_id": "rpt_01HVF8T0M2YTAY3BBNRH0V0"
}'

Responses

200 Successful Response

Field Type Description

operationrequired

string

Kebab-case operation name

operationIdrequired

string

op_-prefixed ULID for audit and SSE correlation

statusrequired

string

Operation lifecycle state

One of: completed, pending, failed

resultoptional

ReportResponse

Command-specific result payload

ReportResponse fields

Field Type Description

idrequired

string

Report identifier (ULID).

namerequired

string

Human-readable report name.

taxonomy_idrequired

string

Taxonomy this report renders against.

generation_statusrequired

string

Computation lifecycle: `generating`, `published`, `failed`. Orthogonal to `filing_status`.

period_typerequired

string

Period cadence: `monthly`, `quarterly`, `annual`.

period_startoptional

string (date)

Current-period start.

period_endoptional

string (date)

Current-period end.

comparativerequired

boolean

True when an auto-generated prior-period column is included.

periodsoptional

PeriodSpec[]

Explicit period columns when the report was created with a multi-period layout.

PeriodSpec fields

Field	Type	Description
`start`required	string (date)	Period start date (inclusive). Window the column rolls up.
`end`required	string (date)	Period end date (inclusive). Window the column rolls up.
`label`required	string	Column header label (e.g. 'FY2025 Q3', '2024', 'YTD').

mapping_idoptional

string

CoA → taxonomy mapping the facts were rolled up through.

ai_generatedoptional

boolean

True when the report was created by an AI agent rather than a user.

Default: false

created_atrequired

string (date-time)

When the report row was created.

last_generatedoptional

string (date-time)

When the facts were last (re)generated.

structuresoptional

StructureSummary[]

Structures available for this report's taxonomy — renderable sections (BS / IS / CF / Equity / Schedules).

StructureSummary fields

Field	Type	Description
`id`required	string	Structure identifier.
`name`required	string	Human-readable structure name.
`block_type`required	string	Structure category: `balance_sheet`, `income_statement`, `cash_flow_statement`, `equity_statement`, `schedule`.

entity_nameoptional

string

Display name of the primary entity the report is tagged to.

filing_statusoptional

string

Filing lifecycle (orthogonal to `generation_status`): `draft`, `under_review`, `filed`, `archived`.

Default: draft

filed_atoptional

string (date-time)

When the report was transitioned to `filed`.

filed_byoptional

string

User ID that transitioned the report to `filed`.

supersedes_idoptional

string

When this report restates an earlier filing, the predecessor's report ID.

superseded_by_idoptional

string

When this report has been restated, the successor's report ID.

source_graph_idoptional

string

Origin graph for received (shared) reports — populated only on the recipient's copy.

source_report_idoptional

string

Origin report ID for received (shared) reports — populated only on the recipient's copy.

shared_atoptional

string (date-time)

When the report was shared into this graph (recipient side).

rule_summaryoptional

object

Counts by rule outcome (e.g. `{'passed': 12, 'failed': 1}`) from the most recent evaluation. Null until rules run.

atrequired

string

ISO-8601 UTC timestamp

createdByoptional

string

User ID that initiated the operation (null for legacy callers)

idempotentReplayoptional

boolean

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

Default: false

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
409	Idempotency-Key conflict — key reused with different body
422	Validation error
429	Rate limit exceeded
500	Internal server error