POST /projects/{ref}/database/query

Execute a SQL query

Detail	Value
Operation ID	cloud.executeQuery
Method	POST
Path	/projects/{ref}/database/query
Connector	Supabase

Parameters

Name	Location	Type	Required
ref	path	string	Yes

Request Body

Field	Type
query	string

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Supabase connection from the Connection dropdown.
3. In the Operation dropdown, select cloud.executeQuery.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Supabase API reference.