Run a read-only Cypher query and return the first 50 rows

Synchronous preview for the Query Workflows UI. Validates the query (same validator as scheduled runs), runs it against the caller's org graph with a 10-second timeout and a hard 50-row cap. Read-only — write keywords are rejected. Not intended for batch use; use the scheduled-execute path for production reads.

Header Parameters

• SlashID-OrgID string required

  The organization ID

  Example: af5fbd30-7ce7-4548-8b30-4cd59cb2aba1

application/json

Request Body required

• query string required

  Possible values: non-empty and <= 10000 characters

  Read-only Cypher query to execute against the org's graph.

• parameters object

  Parameters bound into the query (same as scheduled config).

Responses

• 200
• 400
• 504

---

Preview results.

application/json

• Schema
• Example (from schema)

---

Schema

• columns string[]

  Column names in declared order.

• rows array[]

  Row values, parallel to columns. Cell values are arbitrary JSON.

• duration_ms integer

  Server-measured query duration in milliseconds.

• truncated boolean

  True when the query returned more than the preview cap (50 rows).

{
  "columns": [
    "string"
  ],
  "rows": [
    [
      null
    ]
  ],
  "duration_ms": 0,
  "truncated": true
}

Validation error (query empty, missing MATCH/RETURN, write keyword, etc.).

application/json

• Schema
• Example (from schema)

---

Schema

• code string

  Stable error code (see backend cypher validator sentinels).

• message string

  Human-readable detail. May reference server-side context.

{
  "code": "string",
  "message": "string"
}

Query exceeded the 10-second preview timeout.

application/json

• Schema
• Example (from schema)

---

Schema

• code string

  Stable error code (see backend cypher validator sentinels).

• message string

  Human-readable detail. May reference server-side context.

{
  "code": "string",
  "message": "string"
}