list_sessionsread

Lists your own active visualization sessions — the ones opened by the account whose credential you sent. It never enumerates other people's sessions. Takes no arguments.

Treat the result as a best-effort list rather than a complete one: a session you know is open can be absent. The more reliable source is the viewer's own address bar — the session= parameter of their visualization URL is the same id. Every other tool takes the session_id directly and is unaffected.

get_session_inforead

Returns a plain-text schema summary for one session — not JSON. The result is a newline-separated block giving the session id, node and edge counts, the node id column, and the node and edge column names with their dtypes, plus the workbook title and description when they are set. Call this before your first query and choose column names only from the schema it returns.

Every column of the session is listed. Number, text and boolean columns also carry a short summary of what they hold: a numeric range such as [number, 0 to 0.14], all <value> when every row shares one number, 1 distinct when they share a value the summary will not state exactly, a distinct-value count such as [string, 12 distinct] for text, or empty when the column holds no values. A count shown as 40000+ distinct means the column reaches the counting limit. Range bounds are rounded outward, so a filter built from them never excludes a row the column holds. Columns of other types, such as dates, are listed with their dtype and no summary. Summaries are computed per axis and are skipped when the column count multiplied by the row count is large — roughly 2 million, so a 250-column graph keeps them to about 8,000 rows. A distinct count costs more than a range, so text and boolean columns stop being counted about twice as soon, near 1 million; the reply then says distinct counts skipped while ranges continue. The reply says per-column summaries skipped when all of them stop, and summaries unavailable for N column(s) when a column's values could not be read. A range bound is the column's own smallest or largest value, rounded outward when four significant digits cannot state it exactly; summaries describe the whole dataset and do not narrow to a filtered view. Row data itself comes from query_graph.

Arguments: session_id (required).

query_graphread

Runs a read-only query to filter, traverse, or summarize the graph.

A query that matches nothing returns success with zero rows. Some malformed shapes do the same, so treat an empty result as unverified until you have confirmed the columns and values exist. One case is handled for you: when a string filter matches nothing exactly, the query is retried once matching that value ignoring case and punctuation, and if that matches, the reply names the filters that were loosened. The retry applies only to the legacy JSON GFQL form, never to a Cypher query.

create_collectionowner

Colors the nodes or edges matching a query, and the viewer sees the change immediately. See Collections for how collections stack and the palette list.

Validate the expression with query_graph first, then pass the identical string here. The response carries collection.matchCount — the number of elements colored, or null when the count is unknown. Do not read null as zero.

A collection whose name already exists is replaced, not added alongside. Vary the name to keep both.

list_collectionsread

Lists the collections on the graph, each with its id, name, position (0 = rendered on top), and color. Call this before any tool that takes a collection_id.

Arguments: session_id (required).

update_collectionowner

Renames or recolors an existing collection. Does not change which elements match.

Arguments: session_id, collection_id (both required); name, node_color, palette (all optional, omit rather than passing null).

delete_collectionowner

Deletes one collection, leaving the rest intact. The built-in global background layer cannot be deleted.

Arguments: session_id, collection_id (both required).

reorder_collectionsowner

Sets render order. Where collections overlap, an earlier one is painted on top of a later one. Ids left out of the array keep their relative order after the listed ones.

Arguments: session_id, order (array of collection ids, first = on top).

reset_collectionsowner

Clears every collection at once, returning the graph to its default view.

Arguments: session_id (required).