---
title: "Run a SQL statement"
method: POST
path: "/gateway/{actor}/inspector/database/execute"
---

# Run a SQL statement

`POST /gateway/{actor}/inspector/database/execute`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `actor` string, required

## Headers

- `Authorization` string

## Request body

- object
  - `sql` string, required: SQL statement to run against the actor's SQLite database.
  - `args` unknown[]: Positional bind parameters.
    - unknown
  - `properties` object: Driver-specific execution options.

## Response `200`

Result rows

- object
  - `rows` object[]

## Other responses

- `401`: Unauthorized

## Changes

- **2026-09-29** `0130d6e7eada`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rivet-dev/apis/rivetkit-api/changes/gateway/:actor/inspector/database/execute/post.md)

---

[API](https://skmtc.dev/rivet-dev/apis/rivetkit-api.md) - [All operations](https://skmtc.dev/rivet-dev/apis/rivetkit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rivet-dev/apis/rivetkit-api/revisions/0130d6e7eada?raw)