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, 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. It does not inspect stored values — use query_graph for that.

Very wide graphs are truncated: at most 120 column names are listed per axis, taken from both ends of the list, and the remainder is reported inline as (+N more not listed). Treat that count as a signal to query for the columns you need rather than assuming the summary is exhaustive.

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. Node steps filter with filter_dict; Edge steps use direction, hops, and edge_match. Numeric comparisons are predicate objects such as {"type":"GT","val":10}; a plain value means equality.

create_collectionowner

Colors the nodes or edges matching a GFQL expression, 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).