> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase

> Connect Supabase to your Atako agents — 4 read and 4 write actions.

Let your agents query and modify your Supabase database and storage — read rows, insert, update, delete, call RPC functions, and list storage buckets and objects.

## Connection

* **Authentication**: API key (Secret key (or legacy service\_role key)).
* **Required settings**:
  * **Project Reference ID** — Project Settings → General → Reference ID (20 lowercase alphanumeric characters)

<Note>
  Supabase → Dashboard → Project Settings → API Keys → Copy the secret key (starts with sb\_secret\_…) or the legacy service\_role key (JWT, from "Legacy API Keys"). Both bypass Row-Level Security. Limit its rights via Atako's grant permissions and the database grants you set in Supabase.

  See [Supabase's documentation](https://supabase.com/dashboard/project/_/settings/api-keys).
</Note>

## Read actions (4)

| Action            | Description                                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `describe_schema` | Fetch the OpenAPI description of all tables, views, and functions exposed by this Supabase project.                                   |
| `list_buckets`    | List all storage buckets in the project.                                                                                              |
| `list_objects`    | List objects in a storage bucket under a given prefix.                                                                                |
| `select_rows`     | Read rows from a table or view. Supports PostgREST filters (e.g. "eq.42", "ilike.*foo*"), select, order, limit (max 1000) and offset. |

## Write actions (4)

| Action          | Description                                                                                                                                                         |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `call_function` | Call a PostgreSQL function via RPC. Pass the function arguments as a JSON object.                                                                                   |
| `delete_rows`   | Delete rows from a table matching the given PostgREST filters. Returns no body; read the rows back with select\_rows if needed.                                     |
| `insert_rows`   | Insert one or more rows into a table. Pass an object for a single row or an array for bulk insert. Returns no body; read the rows back with select\_rows if needed. |
| `update_rows`   | Update rows in a table matching the given PostgREST filters. Returns no body; read the rows back with select\_rows if needed.                                       |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.