Skip to content
SolidRusT.ai

Graph traversal query

POST
/data/v1/query/graph

Traverse the knowledge graph from a starting entity. Returns connected entities and relationships up to the specified depth.

Use this to discover related content that vector search might miss. Example: starting from “Nightmare” reveals connected ships, skills, and modules.

Authorizations

Request Body required

object
entity_name
required

Starting entity name for graph traversal

string
Nightmare
relationship_types

Filter by relationship types (e.g. ‘requires’, ‘similar_to’)

Array<string>
direction

Traversal direction

string
default: both
Allowed values: in out both
depth

How many hops to traverse

integer
default: 2 >= 1 <= 5
limit

Maximum entities to return

integer
default: 50 >= 1 <= 200

Responses

200

Successful response

object
entity_name

The starting entity name

string
entities_found
Array<object>
object
id
string
name
string
entity_type

Entity category (e.g. ship, module, skill)

string
properties
object
key
additional properties
any
relationships
Array<object>
object
source_name
string
target_name
string
relationship_type

Type of connection (e.g. requires, similar_to, has_module)

string
properties
object
key
additional properties
any
total_entities
integer
total_relationships
integer

400

Invalid request

object
error
object
message
string
type
string
code
string
param
string

401

Invalid or missing API key

object
error
object
message
string
type
string
code
string
param
string