returns [InformationBlockSummary!]!
List Information Blocks as identities and counts, one row per block.
The rows, filters, order and page of informationBlocks, read in one
query instead of an envelope build per block — the call that fills a
picker or a rail. factCount says whether a block carries facts for
the entity read (a library-seeded structure variant carries none);
a block's atoms come from informationBlock(id).
| Name | Type | Description |
|---|---|---|
| blockType | String | Filter to one registered block type, e.g. schedule. |
| category | String | Filter on the registry entry's category label, e.g. Close or Reporting. |
| limit | Int | Maximum rows to return, 1-1000. Omit to use this field's own default; out of range raises INVALID_PAGINATION. |
| offset | Int | Rows to skip before returning, 0 or greater. Out of range raises INVALID_PAGINATION. |
| scenarioId | String | A forecast block's structure id; its entity scopes the list when entityId is omitted. |
| entityId | String | The entity whose blocks and facts to list. Omit for the group parent. |
One row of a block list: the envelope's identity with counts in place of its atoms. Read in one query, so a graph's whole catalogue lists in the time one envelope builds.
| Field | Type | Description |
|---|---|---|
| id | String! | The block's structure id. |
| blockType | String! | Discriminator — 'schedule', … |
| name | String! | The block's own name — the instance ('FY27 Operating Budget'), where displayName is its type's label ('Forecast'). |
| displayName | String! | Registry-sourced display label (e.g., 'Schedule'). |
| category | String! | Registry-sourced sidebar grouping ('Close', 'Reporting', …). |
| taxonomyId | String | Source taxonomy the Structure was seeded from. |
| taxonomyName | String | Display name of the source taxonomy. |
| entityId | String | The entity whose books the block reads: its owner for a schedule, reconciliation or forecast; the entity asked for, else the group parent, on a block shared by the group. Null on the library. |
| factCount | Int! | Facts in the block's scope for that entity, every set — what its envelope carries. Zero on a library-seeded structure variant and on a schedule that has run off into history, which a picker leaves out. |
| connectionCount | Int! | Arcs the block's structure carries. |
{ informationBlockSummaries { id blockType name displayName } }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": "{ informationBlockSummaries { id blockType name displayName } }"}'