Query

Execute SQL Statement

SQL over the graph's columnar tables (DuckDB) — a relational lens on the same graph-centric data, often ahead of the materialized graph. Use ? placeholders with the parameters array to prevent injection. Read-only (SELECT only), 30s timeout, 10,000 row limit. Not available on shared repositories.

post/v1/graphs/{graph_id}/query/sql

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/v1/graphs/{graph_id}/query/sql
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Request body

sqlstring required

SQL query over the graph's columnar tables (DuckDB) — a relational lens on the same graph-centric data, often ahead of the materialized graph. Use ? placeholders or $param_name for dynamic values to prevent SQL injection.

Example request

{
  "parameters": [
    "Company",
    100
  ],
  "sql": "SELECT * FROM Entity WHERE entity_type = ? LIMIT ?"
}

Response

Successful Response

columnsstring[] required

Column names

row_countinteger required

Number of rows returned

execution_time_msnumber required

Query execution time

Changes

No recorded changes to this operation across all 1 revision of this API.