ConnectorQueryResponse
Connector query result. Successful responses include the returned body and any extracted rows; connector failures return success=false with error instead of raising an HTTP error.
error object
- string
- null
status_code object
Upstream HTTP status. Present when the connector exposes response metadata — on success and on an HTTP error body.
- integer
- null
reason_phrase object
Upstream status text ('Not Found'), completing the status line. Null when the connector does not expose it.
- string
- null
http_version object
Protocol the exchange actually used ('HTTP/1.1'), which the client negotiates rather than the caller choosing.
- string
- null
response_headers object
Upstream response headers, when exposed.
- object
- null
request_method object
HTTP method the connector actually sent. May differ from the requested method: a connector that tunnels reads through OData $batch sends POST for a GET. Null when not exposed.
- string
- null
request_url object
URL the connector sent upstream, with credentials masked. It is null when the URL is not exposed.
- string
- null
request_headers object
Headers the connector actually sent. Credential values are masked by the connector; header names are preserved. Null when not exposed.
- object
- null
rows object
Rows extracted from the JSON body — OData v2 (d.results) / v4 (value) or a plain top-level JSON array — capped at limit. Null when the body has no row shape; [] is a real, empty result.
- object[]
- null
columns object
Row keys in first-appearance order.
- string[]
- null
row_count object
- integer
- null
Rows were cut at limit (use $top/$skip to page).
falseraw object
Response body, size-capped. The bytes that came back verbatim when the connector records them, else the body as the connector returned it — parsed JSON for a driver that parses, so the type varies by connector. Null when a parsed body exceeds the cap and rows carry the data.
- Option 1
- null
false{
"success": true,
"error": "string",
"status_code": 0,
"reason_phrase": "string",
"http_version": "string",
"response_headers": {},
"request_method": "string",
"request_url": "string",
"request_headers": {},
"rows": [
{}
],
"columns": [
"string"
],
"row_count": 0,
"truncated": false,
"raw_truncated": false,
"latency_ms": 0
}