---
title: "ExecuteQuery"
method: POST
path: "/textql.rpc.public.sandbox_query.SandboxQueryService/ExecuteQuery"
tags: ["SandboxQueryService"]
---

# ExecuteQuery

`POST /textql.rpc.public.sandbox_query.SandboxQueryService/ExecuteQuery`

## Headers

- `Connect-Protocol-Version` 1, required — Define the version of the Connect protocol
- `Connect-Timeout-Ms` number — Define the timeout, in ms

## Request body

- union
  - object
    - `sourceName` string
    - `connectorId` integer
    - `parameters` TextqlRpcPublicSandboxQuerySandboxQueryParam[]
      - `name` string
      - `value` string
    - `maxRows` union
      - integer
      - string, int64
    - `appDb` TextqlRpcPublicSandboxQueryAppDBTemplate, required
      - `query` string — SQL to run against the app's private DuckDB database
  - object
    - `sourceName` string
    - `connectorId` integer
    - `parameters` TextqlRpcPublicSandboxQuerySandboxQueryParam[]
      - `name` string
      - `value` string
    - `maxRows` union
      - integer
      - string, int64
    - `libraryTql` TextqlRpcPublicSandboxQueryLibraryTQLTemplate, required
      - `tqlPath` string — library path to a .tql file
  - object
    - `sourceName` string
    - `connectorId` integer
    - `parameters` TextqlRpcPublicSandboxQuerySandboxQueryParam[]
      - `name` string
      - `value` string
    - `maxRows` union
      - integer
      - string, int64
    - `sqlQuery` TextqlRpcPublicSandboxQuerySqlQueryTemplate, required
      - `query` string — SQL with :param placeholders

## Response `200`

Success

- TextqlRpcPublicSandboxQuerySandboxExecuteQueryResponse
  - `arrowData` string, byte
  - `totalRows` union
    - integer
    - string, int64
  - `error` string
  - `refreshedToken` string, nullable

## Other responses

- `default` — Error

---

[API](https://skmtc.net/textql/apis/textql-rpc-platform.md) · [All operations](https://skmtc.net/textql/apis/textql-rpc-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textql/textql-rpc-platform/revisions/31ce2b0c4427/schema)