> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase

> Supabase is an open-source backend-as-a-service providing a Postgres database, authentication, storage, and real-time subscription APIs for building modern applications

![Supabase logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/supabase.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=d1244ef7f5bf323526d3986e44fedf19)

* **Category:** developer tools
* **Auth:** OAUTH2, API\_KEY
* **Composio-managed OAuth available?** Yes
* **Tools:** 235
* **Triggers:** 0
* **Slug:** `SUPABASE`
* **Version:** 20261103\_00

## Frequently Asked Questions

> [accordion] Limit Supabase scopes in the user's OAuth app, not through Composio's default app
>
> For Supabase permission scoping, configure the desired permissions in the user's own OAuth app and create the Composio auth config with that app. The default Composio OAuth app may be configured with broader permissions.

## Tools

> [accordion] Accept Invite External Jit Access
>
> **Slug:** `SUPABASE_ACCEPT_INVITE_EXTERNAL_JIT_ACCESS`
>
> Accept an invitation for JIT database access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create project api key
>
> **Slug:** `SUPABASE_ALPHA_CREATE_API_KEY`
>
> Creates a publishable or secret API key for an existing Supabase project, optionally with a description.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **name** `string` *required*
>
> Name for the API key. Must start with a lowercase letter or underscore, followed only by lowercase alphanumeric characters or underscores. Example: 'my\_api\_key\_01'.
>
> **type** `string ("publishable" | "secret")` *required*
>
> Specifies the type of API key: 'publishable' for client-side use or 'secret' for server-side operations.
>
> **description** `string`
>
> Optional human-readable description for the API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an API key from the project
>
> **Slug:** `SUPABASE_ALPHA_DELETE_API_KEY`
>
> Permanently deletes a specific API key (identified by `id`) from a Supabase project (identified by `ref`), revoking its access.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the API key that needs to be deleted from the project.
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project from which the API key is to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete third party auth config
>
> **Slug:** `SUPABASE_ALPHA_DELETE_THIRD_PARTY_AUTH_INTEGRATION`
>
> Removes a third-party authentication provider (e.g., Google, GitHub) from a Supabase project's configuration; this immediately prevents users from logging in via that method.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **tpa\_id** `string` *required*
>
> The unique identifier (ID) of the third-party authentication provider configuration to be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a third-party integration
>
> **Slug:** `SUPABASE_ALPHA_GET_THIRD_PARTY_INTEGRATION`
>
> Retrieves the detailed configuration for a specific third-party authentication (TPA) provider, identified by `tpa_id`, within an existing Supabase project specified by `ref`.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier (reference) of the Supabase project.
>
> **tpa\_id** `string` *required*
>
> The unique identifier of the specific third-party authentication provider configuration to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List third-party auth integrations for project
>
> **Slug:** `SUPABASE_ALPHA_LIST_THIRD_PARTY_AUTH_INTEGRATIONS`
>
> Lists all configured third-party authentication provider integrations for an existing Supabase project (using its `ref`), suitable for read-only auditing or verifying current authentication settings.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an API key for the project
>
> **Slug:** `SUPABASE_ALPHA_UPDATE_API_KEY`
>
> Updates the description of an existing Supabase project API key without regenerating the key string.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the API key that needs to be updated.
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project to which the API key belongs.
>
> **description** `string`
>
> Optional new description for the API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Append Resumable Upload
>
> **Slug:** `SUPABASE_APPEND_RESUMABLE_UPLOAD`
>
> Append data to a TUS resumable upload. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> **upload\_offset** `integer` *required*
>
> Expected byte offset returned by the upload HEAD response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Append Resumable Upload Signed
>
> **Slug:** `SUPABASE_APPEND_RESUMABLE_UPLOAD_SIGNED`
>
> Append data to a signed resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **x\_signature** `string` *required*
>
> Signed upload token from SUPABASE\_CREATE\_SIGNED\_UPLOAD\_URL; forwarded only to this project Storage endpoint.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> **upload\_offset** `integer` *required*
>
> Expected byte offset returned by the upload HEAD response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Apply a database migration
>
> **Slug:** `SUPABASE_APPLY_A_MIGRATION`
>
> Applies a tracked SQL database migration to a Supabase project, for schema changes or other DDL/DML operations. You can provide a migration name, rollback SQL, and an idempotency key to help prevent duplicate tracking.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project (e.g., 'pamqaklsszmjzugtywow'). Found in Project Settings > General > Reference ID.
>
> **name** `string`
>
> A unique name for the migration to track it in the migration history. If not provided, a default name will be assigned.
>
> **query** `string` *required*
>
> The SQL migration query to execute against the project's database. Must be at least 1 character long.
>
> **rollback** `string`
>
> Optional SQL query to rollback/undo this migration if needed.
>
> **idempotency\_key** `string`
>
> A unique key to ensure the same migration is tracked only once. If provided, prevents duplicate migrations with the same key from being applied.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Apply Project Addon
>
> **Slug:** `SUPABASE_APPLY_PROJECT_ADDON`
>
> Apply or update billing addons and compute instance size. Changes may affect billing; inspect the project plan before modifying addons.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Authorize Jit Access
>
> **Slug:** `SUPABASE_AUTHORIZE_JIT_ACCESS`
>
> Authorize user-to-role mappings for JIT access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Beta activate custom hostname for project
>
> **Slug:** `SUPABASE_BETA_ACTIVATE_CUSTOM_HOSTNAME`
>
> Activates a previously configured custom hostname for a Supabase project, assuming DNS settings are verified externally.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier (project ID) of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Activate vanity subdomain for project
>
> **Slug:** `SUPABASE_BETA_ACTIVATE_VANITY_SUBDOMAIN`
>
> Activates a vanity subdomain for the specified Supabase project (e.g., 'my-brand.supabase.co'). Important notes: - Vanity subdomains require a paid plan (Pro/Team/Enterprise) - Usage of vanity subdomains and custom domains is mutually exclusive - After activation, your project's auth services will no longer work on the original \{project-ref}.supabase.co hostname - Schedule a downtime window to update client code and OAuth providers before activating
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project.
>
> **vanity\_subdomain** `string` *required*
>
> Vanity subdomain to activate (e.g., 'my-example-brand'). Must be 1-63 alphanumeric characters or hyphens; cannot start or end with a hyphen.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Authorize user through OAuth
>
> **Slug:** `SUPABASE_BETA_AUTHORIZE_USER_THROUGH_OAUTH`
>
> Requests Supabase OAuth 2.0 authorization for a registered application and returns the redirect location when the endpoint responds with a redirect, or status and error information otherwise.
>
> #### Input Parameters
>
> **scope** `string`
>
> Space-separated list of OAuth scopes for requested permissions on user resources (e.g., 'email profile', 'storage.objects.read').
>
> **state** `string`
>
> Opaque value to maintain state between request and callback; returned unmodified to aid CSRF prevention.
>
> **client\_id** `string` *required*
>
> Unique identifier for the OAuth client application, registered with Supabase. Must be a valid client\_id from a registered OAuth application.
>
> **redirect\_uri** `string` *required*
>
> URI where Supabase redirects the user after authorization; must exactly match a registered URI for the client application.
>
> **response\_mode** `string`
>
> Specifies how authorization response parameters are returned (e.g., 'query', 'fragment', 'form\_post'). Default is determined by `response_type` if not specified.
>
> **response\_type** `string ("code" | "id_token token" | "token")` *required*
>
> Specifies the authorization flow type: 'code' for Authorization Code Grant; 'token' for Implicit Grant (access token); 'id\_token token' for OIDC hybrid flows (ID and access tokens).
>
> **code\_challenge** `string`
>
> PKCE code challenge to secure authorization code grants, typically a BASE64URL-encoded SHA256 hash of `code_verifier`.
>
> **code\_challenge\_method** `string ("S256" | "plain" | "sha256")`
>
> Method to derive `code_challenge` for PKCE: 'S256'/'sha256' for SHA256 hashing; 'plain' sends verifier as is (not for production if hashing possible). Required if `code_challenge` is provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check vanity subdomain availability
>
> **Slug:** `SUPABASE_BETA_CHECK_VANITY_SUBDOMAIN_AVAILABILITY`
>
> Checks whether a vanity subdomain is available for a Supabase project without reserving or assigning it. The endpoint requires a Pro, Team, or Enterprise organization plan.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **vanity\_subdomain** `string` *required*
>
> The desired vanity subdomain to check for availability (e.g., 'my-app'). Must be 1-63 alphanumeric characters or hyphens; cannot start or end with a hyphen.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Setup read replica for project
>
> **Slug:** `SUPABASE_BETA_CREATE_READ_REPLICA`
>
> Provisions a read-only replica for a Supabase project in a specified supported AWS region to enhance read performance and reduce latency. This beta feature requires a Pro, Team, or Enterprise organization plan.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project.
>
> **read\_replica\_region** `string ("ap-east-1" | "ap-northeast-1" | "ap-northeast-2" | "ap-south-1" | "ap-southeast-1" | "ap-southeast-2" | "ca-central-1" | "eu-central-1" | "eu-central-2" | "eu-north-1" | "eu-west-1" | "eu-west-2" | "eu-west-3" | "sa-east-1" | "us-east-1" | "us-east-2" | "us-west-1" | "us-west-2")` *required*
>
> AWS region for the read replica; selecting one closer to users improves performance and reduces latency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enable project database webhooks
>
> **Slug:** `SUPABASE_BETA_ENABLE_DATABASE_WEBHOOKS`
>
> Enables database webhooks for the Supabase project `ref`, triggering real-time notifications for INSERT, UPDATE, or DELETE events.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier for the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Beta get project's custom hostname config
>
> **Slug:** `SUPABASE_BETA_GET_PROJECT_CUSTOM_HOSTNAME_CONFIG`
>
> Retrieves a Supabase project's custom hostname configuration, including its status, SSL certificate, and ownership verification, noting that availability may depend on the project's plan.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. This ID can typically be found in your project's dashboard URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve network bans for project
>
> **Slug:** `SUPABASE_BETA_GET_PROJECT_NETWORK_BANS`
>
> Retrieves the list of banned IPv4 addresses for a Supabase project using its unique project reference string; this is a read-only operation.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique project reference identifier for the Supabase project. Must be a valid 20-character project ref. You can retrieve valid project refs using the 'List all projects' action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project network restrictions
>
> **Slug:** `SUPABASE_BETA_GET_PROJECT_NETWORK_RESTRICTIONS`
>
> Retrieves a Supabase project's network restriction settings, including IPv4 and IPv6 CIDR allowlists, entitlement, and application status. The response may also include the previous configuration while a change is pending.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique project reference ID (also called project ID or ref). This is a 20-character alphanumeric string that identifies the Supabase project. Can be found in the project URL or retrieved via SUPABASE\_LIST\_ALL\_PROJECTS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project pgsodium config
>
> **Slug:** `SUPABASE_BETA_GET_PROJECT_PGSODIUM_CONFIG`
>
> Retrieves the PGSodium configuration, including the root encryption key, for an existing Supabase project identified by its `ref`.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project SSL enforcement configuration
>
> **Slug:** `SUPABASE_BETA_GET_PROJECT_SSL_ENFORCEMENT_CONFIG`
>
> Retrieves the SSL enforcement configuration for a specified Supabase project, indicating if SSL connections are mandated for its database.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project. This can typically be found in your project's dashboard URL (e.g., `https://supabase.com/dashboard/project/<project-ref>`).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current vanity subdomain config
>
> **Slug:** `SUPABASE_BETA_GET_VANITY_SUBDOMAIN_CONFIG`
>
> Fetches the current vanity subdomain configuration for a Supabase project, including its status and any custom domain name. The endpoint requires a Pro, Team, or Enterprise organization plan.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project for which to fetch the vanity subdomain configuration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove project network bans
>
> **Slug:** `SUPABASE_BETA_REMOVE_NETWORK_BANS`
>
> Removes specified IPv4 addresses from a Supabase project's network ban list, granting immediate access; IPs not currently banned are ignored.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **ipv4\_addresses** `array` *required*
>
> A list of IPv4 addresses to be removed from the project's network ban list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove read replica
>
> **Slug:** `SUPABASE_BETA_REMOVE_READ_REPLICA`
>
> Initiates removal of a specified read replica database from a Supabase project. This beta operation requires a valid replica identifier and permission to manage read replicas; redirect application traffic before removal.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique project reference ID (20 lowercase characters, e.g. 'abcdefghijklmnopqrst'). Found in project settings or URL.
>
> **database\_identifier** `string` *required*
>
> The unique identifier of the read replica database to remove. Obtain from the project's database settings or read replica listing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute project database query
>
> **Slug:** `SUPABASE_BETA_RUN_SQL_QUERY`
>
> Executes PostgreSQL queries against a Supabase project's database for data retrieval, modification, or schema operations. Read-only mode does not prevent detected INSERT, UPDATE, or DELETE statements from making changes.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project (used in the URL path). Must be exactly 20 lowercase letters (a-z). Can be found in Project Settings > General > Reference ID in the Supabase Dashboard, or from the dashboard URL: [https://supabase.com/dashboard/project/\&lt;project-ref](https://supabase.com/dashboard/project/\&lt;project-ref)>. Can also be provided as 'project\_ref'.
>
> **query** `string` *required*
>
> The SQL query to be executed against the project's database. Can also be provided as 'sql'. CRITICAL - Single Quote Handling: Single quotes that delimit SQL string literals (e.g., 'John', '3 days') work normally when transmitted via JSON. However, apostrophes and single quotes WITHIN string content MUST be escaped using PostgreSQL's standard escaping (doubling the quote: ''). Examples: ✓ CORRECT: SELECT 'I''m here' (apostrophe in content is escaped as '') ✓ CORRECT: INSERT INTO users (bio) VALUES ('She said ''hello''') ✓ CORRECT: SELECT '\{ "msg": "I''m ready" }'::jsonb (apostrophe inside JSON string is escaped) ✗ WRONG: SELECT 'I'm here' (syntax error - apostrophe breaks the string) ✗ WRONG: SELECT '\{ "msg": "I'm ready" }'::jsonb (syntax error in JSON content) IMPORTANT - PostgreSQL Array Syntax: For columns of type text\[], integer\[], etc., do NOT use JSON array syntax like '\["item1", "item2"]' as PostgreSQL will reject it. Use PostgreSQL array syntax instead: (1) ARRAY constructor: ARRAY\['item1', 'item2'], or (2) Curly brace literal: '\{"item1", "item2"}'. IMPORTANT - PostgreSQL Configuration Parameters: To reference Supabase secrets or config parameters, use current\_setting() with the correct parameter name (e.g., current\_setting('app.settings.my\_secret')). Parameter names must not contain sanitization placeholders like '\<URL>', '\<IP\_ADDRESS>', etc. Note: Complex DDL operations (CREATE TABLE with multiple indexes, CREATE VIEW with joins, large data migrations) may timeout if they exceed the Supabase API's internal timeout limit (\~60 seconds). For long-running operations, consider breaking them into smaller queries or using a direct database connection.
>
> **read\_only** `boolean`
>
> If true, executes the query in a read-only transaction. Useful for safety when only fetching data without modifying the database. IMPORTANT: This parameter is incompatible with data modification statements. For INSERT, UPDATE, and DELETE statements, if set to true, it will be automatically overridden to false to allow the operation to proceed. For DDL statements (CREATE, ALTER, DROP, etc.), read\_only=true will cause an error - you must set it to false or omit it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Beta update project network restrictions
>
> **Slug:** `SUPABASE_BETA_UPDATE_PROJECT_NETWORK_RESTRICTIONS`
>
> Updates network access restrictions (IPv4/IPv6 CIDR lists) for a Supabase project. Changes may terminate existing connections that do not match the new rules; the returned status indicates whether the configuration is stored or applied.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project.
>
> **dbAllowedCidrs** `array`
>
> List of IPv4 addresses or CIDR notations for database access; `[]` removes all IPv4 restrictions, `null`/omitted leaves current IPv4 restrictions unchanged.
>
> **dbAllowedCidrsV6** `array`
>
> List of IPv6 addresses or CIDR notations for database access; `[]` removes all IPv6 restrictions, `null`/omitted leaves current IPv6 restrictions unchanged.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upgrade the project's PostgreSQL version
>
> **Slug:** `SUPABASE_BETA_UPGRADE_PROJECT_POSTGRES_VERSION`
>
> Initiates an asynchronous upgrade of a Supabase project's PostgreSQL database to a specified `target_version` from a selected `release_channel`, returning a `tracking_id` to monitor status; the `target_version` must be available in the chosen channel.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The project's unique reference ID.
>
> **target\_version** `string` *required*
>
> Target PostgreSQL version (e.g., '15.1.0.123'); must be available in the specified `release_channel`.
>
> **release\_channel** `string ("alpha" | "beta" | "ga" | "internal" | "withdrawn")` *required*
>
> Release channel for selecting the PostgreSQL version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel Project Restoration
>
> **Slug:** `SUPABASE_CANCEL_PROJECT_RESTORATION`
>
> Cancel project restoration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Copy Storage Object
>
> **Slug:** `SUPABASE_COPY_STORAGE_OBJECT`
>
> Copy an object. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Count action runs
>
> **Slug:** `SUPABASE_COUNT_ACTION_RUNS`
>
> Counts the number of action runs for a Supabase project using a HEAD request. Use this when you need to retrieve the total count of action runs without fetching the full list of runs.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Count Function Results
>
> **Slug:** `SUPABASE_COUNT_FUNCTION_RESULTS`
>
> Count rows from a known exposed table-valued function using HEAD, without a body. PostgREST enforces a read-only transaction; functions attempting database writes fail. Uses an elevated secret/service\_role key that bypasses Row Level Security. OAuth requires secrets:read; fine-grained PATs require api\_gateway\_keys\_read and api\_gateway\_keys\_secret\_read for project-key discovery. Not for scalar functions.
>
> #### Input Parameters
>
> **count** `string ("exact" | "planned" | "estimated")`
>
> Count strategy: exact (default) may be slow on large results; planned uses PostgreSQL statistics; estimated uses exact below the server's db-max-rows threshold and planned above it.
>
> **limit** `integer`
>
> Optional page size; does not limit the total matching-row count.
>
> **order** `string`
>
> PostgREST result ordering, e.g. created\_at.desc.
>
> **offset** `integer`
>
> Optional page offset; does not subtract from the total count.
>
> **schema** `string`
>
> Exposed schema sent as Accept-Profile; omit for the default schema.
>
> **select** `string`
>
> PostgREST column/embedded-resource selection, e.g. id,name.
>
> **filters** `object`
>
> PostgREST result filters, e.g. \{'rating': 'gt.8'} or \{'or': '(rating.gt.8,featured.is.true)'}. Do not include query controls or names used in arguments.
>
> **arguments** `object`
>
> Named function arguments as PostgreSQL query-literal strings, e.g. \{'minimum': '10', 'ids': '\{1,2,3}'}. Values are URL-encoded by the transport, not JSON-serialized. Omit for a function without arguments. Argument names cannot overlap filters or PostgREST query controls.
>
> **project\_ref** `string` *required*
>
> Unique 20-character reference ID of the Supabase project.
>
> **function\_name** `string` *required*
>
> Name of the exposed, read-only table-valued Postgres function.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Count Table Rows
>
> **Slug:** `SUPABASE_COUNT_TABLE_ROWS`
>
> Count matching rows in an exposed table or view without downloading rows. Uses an elevated secret/service-role key and bypasses Row Level Security. OAuth requires secrets:read; fine-grained personal access tokens require api\_gateway\_keys\_read and api\_gateway\_keys\_secret\_read.
>
> #### Input Parameters
>
> **count** `string ("exact" | "planned" | "estimated")`
>
> Count strategy: exact counts all matches and may be slow on large tables; planned uses PostgreSQL statistics; estimated uses exact below the server's row threshold and planned above it.
>
> **limit** `integer`
>
> Page size, including zero. Does not cap the matching-row total.
>
> **order** `string`
>
> PostgREST ordering expression, for example created\_at.desc.
>
> **table** `string` *required*
>
> Name of an exposed table or view, without a schema prefix.
>
> **offset** `integer`
>
> Rows to skip for the requested page, not the matching-row total.
>
> **schema** `string`
>
> Exposed schema to select through Accept-Profile; omit for the default schema.
>
> **select** `string`
>
> PostgREST column and embedded-resource selection, for example id,name.
>
> **filters** `object`
>
> PostgREST filters mapping columns or logical operators to expressions, for example \{'status': 'eq.active', 'or': '(age.lt.18,age.gt.65)'}. Use the dedicated fields for select, order, limit, and offset.
>
> **project\_ref** `string` *required*
>
> Unique 20-character reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create new project
>
> **Slug:** `SUPABASE_CREATE_A_PROJECT`
>
> Creates a new Supabase project, requiring a unique name (no dots) within the organization; project creation is asynchronous.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the new project; must be unique within the organization and not contain dots.
>
> **plan** `string ("free" | "pro")`
>
> Subscription plans (now set at the organization level).
>
> **region** `string ("ap-east-1" | "ap-northeast-1" | "ap-northeast-2" | "ap-south-1" | "ap-southeast-1" | "ap-southeast-2" | "ca-central-1" | "eu-central-1" | "eu-central-2" | "eu-north-1" | "eu-west-1" | "eu-west-2" | "eu-west-3" | "sa-east-1" | "us-east-1" | "us-east-2" | "us-west-1" | "us-west-2")` *required*
>
> Geographical region for the project's server and database.
>
> **db\_pass** `string` *required*
>
> Password for the new database (required). Must be a secure password. IMPORTANT: Store this password securely as it cannot be retrieved later via the API and is needed for direct database connections.
>
> **kps\_enabled** `boolean`
>
> Deprecated and ignored.
>
> **template\_url** `string`
>
> Optional URL to a Supabase project template (e.g., from Git) to initialize the project.
>
> **organization\_id** `string` *required*
>
> The actual organization ID or slug from your Supabase account. IMPORTANT: 'personal' is NOT a valid value - you must use the real organization ID returned by the 'List All Organizations' API endpoint (GET /v1/organizations) or found in your Supabase dashboard settings.
>
> **postgres\_engine** `string ("15")`
>
> Supported major versions of the PostgreSQL engine.
>
> **release\_channel** `string ("alpha" | "beta" | "ga" | "internal" | "withdrawn")`
>
> Available release channels for Supabase software.
>
> **desired\_instance\_size** `string ("12xlarge" | "16xlarge" | "2xlarge" | "4xlarge" | "8xlarge" | "large" | "medium" | "micro" | "small" | "xlarge")`
>
> Available compute instance sizes for a Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk create secrets
>
> **Slug:** `SUPABASE_CREATE_BULK_SECRETS`
>
> Bulk creates secrets for a Supabase project. Secret names must not start with SUPABASE\_; leading and trailing whitespace is stripped from names and values before submission.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (ref) of the Supabase project where secrets will be created.
>
> **secrets** `array` *required*
>
> List of secrets to create. Each secret must have a unique name that doesn't start with SUPABASE\_.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a database branch
>
> **Slug:** `SUPABASE_CREATE_DATABASE_BRANCH`
>
> Creates a new, isolated database branch from an existing Supabase project (identified by `ref`), useful for setting up separate environments like development or testing, which can optionally be linked to a Git branch.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the parent Supabase project.
>
> **region** `string`
>
> Geographical region for the new database branch.
>
> **git\_branch** `string`
>
> Git branch name to associate with this database branch, linking database states to code branches.
>
> **persistent** `boolean`
>
> Specifies if the branch is persistent (true) or ephemeral (false); ephemeral branches might be auto-deleted.
>
> **branch\_name** `string` *required*
>
> A unique name for the new database branch.
>
> **postgres\_engine** `string ("15")`
>
> Desired PostgreSQL engine version for the new branch.
>
> **release\_channel** `string ("alpha" | "beta" | "ga" | "internal" | "withdrawn")`
>
> Release channel for Supabase features on this branch, determining feature stability.
>
> **desired\_instance\_size** `string ("12xlarge" | "16xlarge" | "2xlarge" | "4xlarge" | "8xlarge" | "large" | "medium" | "micro" | "small" | "xlarge")`
>
> Compute instance size for the new database branch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a function
>
> **Slug:** `SUPABASE_CREATE_FUNCTION`
>
> Creates a new serverless Edge Function for a Supabase project (identified by `ref`), requiring valid JavaScript/TypeScript in `body` and a project-unique `slug` identifier.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project's unique identifier (path parameter).
>
> **body** `string` *required*
>
> JavaScript or TypeScript source code for the Edge Function.
>
> **name** `string` *required*
>
> Human-readable name for the function.
>
> **slug** `string` *required*
>
> URL-friendly identifier for the function's route prefix. Must be unique within the project.
>
> **import\_map** `boolean`
>
> If true, enable import map for ES module resolution.
>
> **verify\_jwt** `boolean`
>
> If true, verify JWT in Authorization header before invoking the function. Set to false for public endpoints like webhooks.
>
> **entrypoint\_path** `string`
>
> Path to main function code, relative to project's functions directory. Defaults to `./index.ts` or `./index.js` in function's slug directory.
>
> **import\_map\_path** `string`
>
> Path to import map JSON, relative to project's functions directory; used if `import_map` is true. Defaults to `import_map.json` in function's slug directory.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create CLI login role
>
> **Slug:** `SUPABASE_CREATE_LOGIN_ROLE`
>
> Creates a temporary CLI login role for database access with specified permissions; use when setting up CLI authentication for development or administrative tasks.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project reference ID (unique identifier for the Supabase project).
>
> **read\_only** `boolean` *required*
>
> Whether the login role should have read-only permissions. Set to true for read-only access, false for full access.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create an organization
>
> **Slug:** `SUPABASE_CREATE_ORGANIZATION`
>
> Creates a new Supabase organization, which serves as a top-level container for projects, billing, and team access.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name for the new organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create project signing key
>
> **Slug:** `SUPABASE_CREATE_PROJECT_SIGNING_KEY`
>
> Create a new JWT signing key for a Supabase project, with an optional initial standby or in-use status.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Can also be provided as 'project\_ref'.
>
> **status** `string ("in_use" | "standby")`
>
> Status of a signing key in request.
>
> **algorithm** `string ("EdDSA" | "ES256" | "RS256" | "HS256")` *required*
>
> The cryptographic algorithm to use for the signing key. HS256 is recommended for most use cases.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Resumable Upload
>
> **Slug:** `SUPABASE_CREATE_RESUMABLE_UPLOAD`
>
> Create a TUS resumable upload. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **file** `object`
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> **upload\_length** `integer` *required*
>
> Total upload size in bytes, per the TUS creation extension.
>
> **upload\_metadata** `string` *required*
>
> TUS metadata: comma-separated key base64(value) pairs including bucketName, objectName, contentType and cacheControl.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Resumable Upload Signed
>
> **Slug:** `SUPABASE_CREATE_RESUMABLE_UPLOAD_SIGNED`
>
> Create a signed TUS resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **file** `object`
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **x\_signature** `string` *required*
>
> Signed upload token from SUPABASE\_CREATE\_SIGNED\_UPLOAD\_URL; forwarded only to this project Storage endpoint.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> **upload\_length** `integer` *required*
>
> Total upload size in bytes, per the TUS creation extension.
>
> **upload\_metadata** `string` *required*
>
> TUS metadata: comma-separated key base64(value) pairs including bucketName, objectName, contentType and cacheControl.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Signed Download Url
>
> **Slug:** `SUPABASE_CREATE_SIGNED_DOWNLOAD_URL`
>
> Generate a time-limited download capability for an object. Uses privileged project-key discovery; protect the returned URL.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Signed Download Urls
>
> **Slug:** `SUPABASE_CREATE_SIGNED_DOWNLOAD_URLS`
>
> Generate time-limited download capabilities for multiple objects. Uses privileged project-key discovery; protect the returned URLs.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Signed Upload URL
>
> **Slug:** `SUPABASE_CREATE_SIGNED_UPLOAD_URL`
>
> Create a two-hour signed authorization for uploading a Storage object. OAuth connections need `secrets:read`. Fine-grained personal access tokens need `api_gateway_keys_read` and `api_gateway_keys_secret_read`.
>
> #### Input Parameters
>
> **upsert** `boolean`
>
> Allow the signed upload to overwrite an existing object at this path.
>
> **bucket\_name** `string` *required*
>
> Existing Storage bucket that will receive the object.
>
> **object\_path** `string` *required*
>
> Object path including its file name.
>
> **project\_ref** `string` *required*
>
> Unique 20-character reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create SSO provider configuration
>
> **Slug:** `SUPABASE_CREATE_SSO_PROVIDER`
>
> Creates a new SAML 2.0 Single Sign-On (SSO) provider for a Supabase project, requiring either `metadata_xml` or `metadata_url` for SAML IdP configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project.
>
> **type** `string ("saml")` *required*
>
> Type of the SSO provider; 'saml' (SAML 2.0) is the only supported value.
>
> **domains** `array`
>
> Email domains to associate with this SSO provider; users from these domains will be directed here for authentication.
>
> **metadata\_url** `string`
>
> URL to fetch SAML 2.0 metadata XML. Provide this or `metadata_xml`.
>
> **metadata\_xml** `string`
>
> SAML 2.0 metadata XML document as a string. Provide this or `metadata_url`.
>
> **attribute\_\_mapping\_\_keys** `object`
>
> Maps SAML assertion attributes to custom Supabase JWT claims. Keys are JWT claim names; values specify SAML attribute extraction rules (e.g., `name`, `names`, `default`, `array`).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Storage Bucket
>
> **Slug:** `SUPABASE_CREATE_STORAGE_BUCKET`
>
> Create a Storage bucket. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new third-party auth integration
>
> **Slug:** `SUPABASE_CREATE_THIRD_PARTY_AUTH_INTEGRATION`
>
> Call this to add a new third-party authentication method (OIDC or JWKS) to a Supabase project for integrating external identity providers (e.g., for SSO); the API may also support `custom_jwks` if sent directly.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> **jwks\_url** `string`
>
> URL of the JSON Web Key Set (JWKS) for public key verification. Required if `oidc_issuer_url` is not provided.
>
> **oidc\_issuer\_url** `string`
>
> URL of the OpenID Connect (OIDC) issuer. Required if `jwks_url` is not provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete all branches
>
> **Slug:** `SUPABASE_DELETE_ALL_BRANCHES`
>
> Disables preview branching for a Supabase project, which deletes all remaining branches. IMPORTANT: Before calling this endpoint, you must manually delete all non-default branches. The API will reject the request with a 422 error if non-default branches exist. Use this action when you need to completely disable the preview branching feature for a project. This action is irreversible - all branches will be permanently removed and preview branching will be disabled. Requirements: - Preview branching must be enabled on the project - All non-default branches must be deleted first - Project must be on Pro plan or above to have preview branching
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project for which all database branches will be deleted. This ID can be found in your project's dashboard URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Bucket Lifecycle
>
> **Slug:** `SUPABASE_DELETE_BUCKET_LIFECYCLE`
>
> Delete bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete custom hostname config
>
> **Slug:** `SUPABASE_DELETE_CUSTOM_HOSTNAME_CONFIG`
>
> Deletes an active custom hostname configuration for the project identified by `ref`, reverting to the default Supabase-provided hostname; this action immediately makes the project inaccessible via the custom domain and requires subsequent updates to client, OAuth, and DNS settings.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project for which the custom hostname configuration will be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete branch by id
>
> **Slug:** `SUPABASE_DELETE_DATABASE_BRANCH`
>
> Permanently and irreversibly deletes a specific, non-default database branch by its `branch_id`, without affecting other branches.
>
> #### Input Parameters
>
> **branch\_id** `string` *required*
>
> The unique identifier of the database branch to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete edge function
>
> **Slug:** `SUPABASE_DELETE_EDGE_FUNCTION`
>
> Deletes an Edge Function from a Supabase project by its slug. Use this action when you need to permanently remove a deployed Edge Function that is no longer needed or should be replaced. This action is irreversible — the function cannot be recovered once deleted, though you can redeploy it from source if needed.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref - unique identifier for the Supabase project.
>
> **function\_slug** `string` *required*
>
> Function slug - URL-friendly identifier of the Edge Function to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an edge function by slug
>
> **Slug:** `SUPABASE_DELETE_FUNCTION`
>
> Permanently deletes a specific Edge Function (by `function_slug`) from a Supabase project (by `ref`); this action is irreversible and requires prior existence of both project and function.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project from which the function will be deleted.
>
> **function\_slug** `string` *required*
>
> The unique identifier (slug) of the Edge Function to be deleted. This is typically the name given to the function upon creation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Invite External Jit Access
>
> **Slug:** `SUPABASE_DELETE_INVITE_EXTERNAL_JIT_ACCESS`
>
> Delete an external user's JIT invitation.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **invite\_id** `string` *required*
>
> Documented path parameter invite\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Jit Access
>
> **Slug:** `SUPABASE_DELETE_JIT_ACCESS`
>
> Delete JIT access by user ID.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **user\_id** `string` *required*
>
> Documented path parameter user\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete CLI login roles
>
> **Slug:** `SUPABASE_DELETE_LOGIN_ROLES`
>
> \[Beta] Deletes existing login roles used by the Supabase CLI for the specified project. Use when you need to remove CLI authentication roles that were previously created for project access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique project reference identifier for the Supabase project from which CLI login roles will be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a project
>
> **Slug:** `SUPABASE_DELETE_PROJECT`
>
> Permanently and irreversibly deletes a Supabase project and all associated resources, including databases, storage, and configurations. This action is irreversible — the project cannot be recovered once deleted. Use when you need to completely remove a project from your organization.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project reference identifier (unique identifier for the project). This is typically a 20-character alphanumeric string found in your project URL or via the List All Projects endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete vanity subdomain for project
>
> **Slug:** `SUPABASE_DELETE_PROJECT_VANITY_SUBDOMAIN`
>
> Permanently and irreversibly deletes an active vanity subdomain configuration for the specified Supabase project, reverting it to its default Supabase URL.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk delete secrets
>
> **Slug:** `SUPABASE_DELETE_SECRETS`
>
> Deletes one or more secrets from a Supabase project by their names. This action is irreversible - deleted secrets cannot be recovered. Use this action when you need to remove environment variables or configuration secrets that are no longer needed or should be replaced. Supports both single and bulk deletion operations through the same endpoint.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (ref) of the Supabase project whose secrets should be deleted.
>
> **secret\_names** `array` *required*
>
> List of secret names to delete. Each name must match an existing secret in the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove an SSO provider
>
> **Slug:** `SUPABASE_DELETE_SSO_PROVIDER`
>
> Deletes a specific SSO provider by its ID (`provider_id`) from a Supabase project (`ref`), which disables it and returns its details; ensure this action will not inadvertently lock out users.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier for your Supabase project.
>
> **provider\_id** `string` *required*
>
> The unique identifier (UUID) of the SSO provider to be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Storage Bucket
>
> **Slug:** `SUPABASE_DELETE_STORAGE_BUCKET`
>
> Delete a bucket. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Storage Object
>
> **Slug:** `SUPABASE_DELETE_STORAGE_OBJECT`
>
> Delete a Storage object. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Storage Objects
>
> **Slug:** `SUPABASE_DELETE_STORAGE_OBJECTS`
>
> Delete multiple objects. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Table Rows
>
> **Slug:** `SUPABASE_DELETE_TABLE_ROWS`
>
> Permanently delete matching rows from an exposed Supabase table or view. Uses an elevated secret/service\_role project key, bypassing Row Level Security. Requires filters unless allow\_all\_rows explicitly permits an unfiltered delete. OAuth needs secrets:read; fine-grained PATs need api\_gateway\_keys\_read and api\_gateway\_keys\_secret\_read to reveal the project key.
>
> #### Input Parameters
>
> **count** `string ("exact" | "planned" | "estimated")`
>
> Optional affected-row count strategy; exact can be slower.
>
> **table** `string` *required*
>
> Exposed table or updatable view name, without a schema prefix.
>
> **schema** `string`
>
> Exposed schema sent as Content-Profile; omit for the project's default.
>
> **select** `string`
>
> PostgREST columns/embedded resources to return with representation.
>
> **filters** `object`
>
> PostgREST filters, e.g. \{'id': 'eq.123'} or \{'or': '(status.eq.inactive,expired.is.true)'}. Query controls such as select, order, limit and offset are not filters. Embedded-only filters do not constrain the target table and do not satisfy the safety guard.
>
> **returning** `string ("representation" | "minimal")`
>
> Return deleted rows (representation) or no body (minimal). Omit to use PostgREST's default, minimal.
>
> **project\_ref** `string` *required*
>
> Unique 20-character reference ID of the Supabase project.
>
> **allow\_all\_rows** `boolean`
>
> Explicitly permit deleting without a target-table filter. Defaults to false to prevent accidental full-table deletion. A supplied filter can still match every row; this is not an affected-row limit or a dry run.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Deploy function
>
> **Slug:** `SUPABASE_DEPLOY_FUNCTION`
>
> Deploys Edge Functions to a Supabase project using multipart upload.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Supabase project reference ID (e.g. `qftqfrxipqlzcmjcatfc`).
>
> **file** `object`
>
> File uploaded to Composio (via SDK/MCP). Supports both single TypeScript/JavaScript files and pre-built .zip archives. Use this for large files, binary content, or complex multi-file functions. NOTE: Provide ONLY ONE of file\_content, file\_url, or file - not multiple.
>
> **slug** `string`
>
> Slug of the function to deploy.
>
> **file\_url** `string`
>
> Public URL to download the function code from. Supports GitHub raw URLs and other publicly accessible file URLs. NOTE: Provide ONLY ONE of file\_content, file\_url, or file - not multiple.
>
> **bundleOnly** `boolean`
>
> If true, only bundle the function without publishing it.
>
> **file\_content** `string`
>
> Raw TypeScript/JavaScript source code as a string. Ideal for simple functions or when code is generated dynamically. NOTE: Provide ONLY ONE of file\_content, file\_url, or file - not multiple.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Disable preview branching
>
> **Slug:** `SUPABASE_DISABLE_PREVIEW_BRANCHING`
>
> Disables the preview branching feature for an existing Supabase project, identified by its unique reference ID (`ref`). Note: Preview branching must be enabled on the project for this operation to succeed. If the project does not have preview branching enabled, a 422 error will be returned.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project for which preview branching is to be disabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Disable project readonly mode
>
> **Slug:** `SUPABASE_DISABLE_PROJECT_READONLY`
>
> Temporarily disables a Supabase project's read-only mode for 15 minutes to allow write operations (e.g., for maintenance or critical updates), after which it automatically reverts to read-only.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download private object
>
> **Slug:** `SUPABASE_DOWNLOAD_PRIVATE_OBJECT`
>
> Downloads an object from a private Supabase Storage bucket and returns its bytes as base64 with selected metadata. Choose anon or service-role authorization; anon access requires an allowing storage policy, while service-role access bypasses row-level security. An object version and download filename can optionally be specified.
>
> #### Input Parameters
>
> **auth\_mode** `string ("anon" | "service_role")`
>
> Project role used for authorization. anon only succeeds when the bucket has a storage.objects SELECT policy that allows the anon role; otherwise Supabase returns 400/404 for private objects. service\_role bypasses row-level security and must be selected deliberately.
>
> **version\_id** `string`
>
> Optional object version ID to download instead of the current version.
>
> **bucket\_name** `string` *required*
>
> Name of the private Storage bucket containing the object.
>
> **object\_path** `string` *required*
>
> Full path and file name of the object inside the bucket.
>
> **project\_ref** `string` *required*
>
> Unique 20-character lowercase reference ID of the Supabase project.
>
> **download\_filename** `string`
>
> Optional filename requested through Supabase's download query parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Public Object
>
> **Slug:** `SUPABASE_DOWNLOAD_PUBLIC_OBJECT`
>
> Retrieve an object from a public bucket.
>
> #### Input Parameters
>
> **download** `string`
>
> Documented query parameter download.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Signed Object
>
> **Slug:** `SUPABASE_DOWNLOAD_SIGNED_OBJECT`
>
> Retrieve an object using a presigned URL.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Documented query parameter token.
>
> **download** `string`
>
> Documented query parameter download.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Storage Object
>
> **Slug:** `SUPABASE_DOWNLOAD_STORAGE_OBJECT`
>
> Retrieve a Storage object. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **download** `string`
>
> Documented query parameter download.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Empty Storage Bucket
>
> **Slug:** `SUPABASE_EMPTY_STORAGE_BUCKET`
>
> Empty a bucket. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Exchange auth code for access and refresh token
>
> **Slug:** `SUPABASE_EXCHANGE_OAUTH_TOKEN`
>
> (Beta) Implements the OAuth 2.0 token endpoint to exchange an authorization code or refresh token for access/refresh tokens, based on `grant_type`. This is a standard OAuth 2.0 token endpoint that uses application/x-www-form-urlencoded content type as per OAuth 2.0 specification. Requires a valid registered OAuth application client\_id and client\_secret. For authorization\_code grant type: - Requires valid authorization code obtained from the OAuth authorization flow - Optionally requires code\_verifier if PKCE was used during authorization For refresh\_token grant type: - Requires valid refresh\_token from a previous token exchange
>
> #### Input Parameters
>
> **code** `string`
>
> Authorization code from the server; required if `grant_type` is 'authorization\_code'.
>
> **client\_id** `string` *required*
>
> Application's client ID.
>
> **grant\_type** `string ("authorization_code" | "refresh_token")` *required*
>
> OAuth 2.0 grant type that dictates the token exchange flow.
>
> **redirect\_uri** `string`
>
> Redirect URI from the initial authorization; required if `grant_type` is 'authorization\_code' and it was part of the original request.
>
> **client\_secret** `string` *required*
>
> Application's client secret.
>
> **code\_verifier** `string`
>
> PKCE code verifier; required if PKCE was used with an 'authorization\_code' grant type.
>
> **refresh\_token** `string`
>
> Refresh token for acquiring a new access token; required if `grant_type` is 'refresh\_token'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate TypeScript types
>
> **Slug:** `SUPABASE_GENERATE_TYPESCRIPT_TYPES`
>
> Generates and retrieves TypeScript types from a Supabase project's database; any schemas specified in `included_schemas` must exist in the project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project for which to generate TypeScript types.
>
> **included\_schemas** `string`
>
> Comma-separated database schema names to include in the generated TypeScript types.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get action run status
>
> **Slug:** `SUPABASE_GET_ACTION_RUN`
>
> Retrieves the status and details of a specific action run, including its steps, timestamps, and configuration. Use this to monitor or check the progress of an action execution.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Must be exactly 20 lowercase alphanumeric characters.
>
> **run\_id** `string` *required*
>
> The unique identifier of the action run to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get action run logs
>
> **Slug:** `SUPABASE_GET_ACTION_RUN_LOGS`
>
> Retrieves the execution logs for a specific action run by its ID. Use this to debug action executions, view output messages, and investigate errors that occurred during action runs.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. This is visible in your Supabase project URL (e.g., [https://supabase.com/dashboard/project/\&#123;ref\&#125](https://supabase.com/dashboard/project/\&#123;ref\&#125);).
>
> **run\_id** `string` *required*
>
> The unique identifier for the action run. This is returned when an action is triggered or can be retrieved from the actions list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project auth config
>
> **Slug:** `SUPABASE_GET_AUTH_CONFIG`
>
> Retrieves a Supabase project's authentication settings for read-only inspection, including supported provider configurations, MFA policies, email and SMS templates, security settings, and hooks. The returned configuration may not include every field supplied by the API.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Can also be provided as 'project\_ref'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Authenticated Image Headers
>
> **Slug:** `SUPABASE_GET_AUTHENTICATED_IMAGE_HEADERS`
>
> Get authenticated image transformation headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **download** `string`
>
> Documented query parameter download.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Authenticated Object Headers
>
> **Slug:** `SUPABASE_GET_AUTHENTICATED_OBJECT_HEADERS`
>
> Retrieve authenticated object information headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Authenticated Object Info
>
> **Slug:** `SUPABASE_GET_AUTHENTICATED_OBJECT_INFO`
>
> Retrieve authenticated object information. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Authenticated Object Info Headers
>
> **Slug:** `SUPABASE_GET_AUTHENTICATED_OBJECT_INFO_HEADERS`
>
> Get authenticated object information headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Available Regions
>
> **Slug:** `SUPABASE_GET_AVAILABLE_REGIONS`
>
> Tool to get the list of available regions for creating a new Supabase project. Use when you need to determine which regions are available for project deployment, or to get region recommendations based on geographic location and instance size requirements. Note: This is a Beta endpoint.
>
> #### Input Parameters
>
> **continent** `string ("NA" | "SA" | "EU" | "AF" | "AS" | "OC" | "AN")`
>
> Continent codes for regional recommendations.
>
> **organization\_slug** `string` *required*
>
> Slug of your organization. This is required to retrieve available regions for project creation.
>
> **desired\_instance\_size** `string ("pico" | "nano" | "micro" | "small" | "medium" | "large" | "xlarge" | "2xlarge" | "4xlarge" | "8xlarge" | "12xlarge" | "16xlarge" | "24xlarge" | "24xlarge_optimized_memory" | "24xlarge_optimized_cpu" | "24xlarge_high_memory" | "48xlarge" | "48xlarge_optimized_memory" | "48xlarge_optimized_cpu" | "48xlarge_high_memory")`
>
> Available instance sizes for Supabase projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Backup Schedule
>
> **Slug:** `SUPABASE_GET_BACKUP_SCHEDULE`
>
> Get the project's backup schedule.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a database branch
>
> **Slug:** `SUPABASE_GET_BRANCH`
>
> Retrieves detailed information about a specific database branch by its name and project reference. Use this to check branch status, configuration, and metadata before performing operations on the branch.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference identifier (project ref) of the parent Supabase project. This ID can be found in your project's dashboard URL.
>
> **name** `string` *required*
>
> The unique name of the database branch to retrieve (e.g., 'test-branch-fix', 'staging', 'feature-x').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bucket Lifecycle
>
> **Slug:** `SUPABASE_GET_BUCKET_LIFECYCLE`
>
> Get bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bucket Lifecycle Headers
>
> **Slug:** `SUPABASE_GET_BUCKET_LIFECYCLE_HEADERS`
>
> Get bucket lifecycle response headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get database branch config
>
> **Slug:** `SUPABASE_GET_DATABASE_BRANCH_CONFIG`
>
> Retrieves the read-only configuration and status for a Supabase database branch, typically for monitoring or verifying its settings.
>
> #### Input Parameters
>
> **branch\_id** `string` *required*
>
> Project reference (ref) for the database branch. Must be exactly 20 lowercase alphabetic characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Database Disk
>
> **Slug:** `SUPABASE_GET_DATABASE_DISK`
>
> Get database disk attributes.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Database Metadata
>
> **Slug:** `SUPABASE_GET_DATABASE_METADATA`
>
> Gets database metadata for the given project. Returns information about databases, schemas, and tables structure. Note: This endpoint is deprecated and may be removed in future versions.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref. The unique reference ID of the Supabase project (visible in your Supabase project URL).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Database Openapi
>
> **Slug:** `SUPABASE_GET_DATABASE_OPENAPI`
>
> Get the project's PostgREST OpenAPI specification.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **schema\_name** `string`
>
> The database schema to generate the OpenAPI spec for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Disk Utilization
>
> **Slug:** `SUPABASE_GET_DISK_UTILIZATION`
>
> Get disk utilization.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve a function
>
> **Slug:** `SUPABASE_GET_FUNCTION`
>
> Retrieves detailed information, metadata, configuration, and status for a specific Edge Function using its project reference ID and function slug.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Must be exactly 20 lowercase alphanumeric characters (letters a-z and digits 0-9 only, no hyphens, underscores, or special characters). You can find this in your Supabase project URL (e.g., [https://supabase.com/dashboard/project/\&lt;ref](https://supabase.com/dashboard/project/\&lt;ref)>) or by using the 'List all projects' API.
>
> **function\_slug** `string` *required*
>
> The unique identifier (slug) for the Edge Function.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve a function body
>
> **Slug:** `SUPABASE_GET_FUNCTION_BODY`
>
> Retrieves the body of a specified Supabase Edge Function using its project reference and function slug. This read-only operation does not execute the function or return runtime logs.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **function\_slug** `string` *required*
>
> The unique identifier (slug) of the serverless Edge Function whose body is to be retrieved. This is typically the function's name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get API Health Status
>
> **Slug:** `SUPABASE_GET_HEALTH`
>
> Checks the Supabase API for availability, helping diagnose connectivity issues.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Jit Access
>
> **Slug:** `SUPABASE_GET_JIT_ACCESS`
>
> Get user-to-role mappings for JIT database access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get JIT access config
>
> **Slug:** `SUPABASE_GET_JIT_ACCESS_CONFIG`
>
> Retrieves a Supabase project's just-in-time (JIT) access configuration state using the beta endpoint.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Can also be provided as 'project\_ref'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get legacy signing key
>
> **Slug:** `SUPABASE_GET_LEGACY_SIGNING_KEY`
>
> Deprecated by the provider; no sunset date or replacement is announced. Retrieve signing key information for the project's imported JWT secret. The endpoint may return HTTP 404 when unavailable. Behavior is unchanged.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a migration
>
> **Slug:** `SUPABASE_GET_MIGRATION`
>
> Retrieves a specific database migration entry from the migration history using its version identifier. Use when you need to inspect migration details, SQL statements, or rollback commands for a specific migration version.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Must be exactly 20 lowercase alphanumeric characters (letters a-z and digits 0-9 only, no hyphens, underscores, or special characters). You can find this in your Supabase project URL (e.g., [https://supabase.com/dashboard/project/\&lt;ref](https://supabase.com/dashboard/project/\&lt;ref)>) or by using the 'List all projects' API.
>
> **version** `string` *required*
>
> The version identifier of the migration to fetch. Typically a timestamp-based identifier (e.g., '20260216042751').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get information about an organization
>
> **Slug:** `SUPABASE_GET_ORGANIZATION`
>
> Fetches comprehensive details for a specific Supabase organization using its unique slug.
>
> #### Input Parameters
>
> **slug** `string` *required*
>
> The unique, URL-friendly identifier of the organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Entitlements
>
> **Slug:** `SUPABASE_GET_ORGANIZATION_ENTITLEMENTS`
>
> Get organization entitlements.
>
> #### Input Parameters
>
> **slug** `string` *required*
>
> Organization slug
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get performance advisors
>
> **Slug:** `SUPABASE_GET_PERFORMANCE_ADVISORS`
>
> Retrieves project performance advisors for a Supabase project. Returns a list of performance lints that identify potential issues and optimization opportunities. Note: This endpoint is deprecated.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action. The project must belong to the authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Profile
>
> **Slug:** `SUPABASE_GET_PROFILE`
>
> Get the user's profile.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project
>
> **Slug:** `SUPABASE_GET_PROJECT`
>
> Retrieves detailed information about a Supabase project by reference ID, including its status, database configuration, organization, region, and creation timestamp. Requires a Management API bearer token with appropriate project read access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref - unique identifier (20 lowercase letters) for the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project API key
>
> **Slug:** `SUPABASE_GET_PROJECT_API_KEY`
>
> Retrieves details of a specific API key for a Supabase project by its UUID. Use when you need to inspect a single key's configuration, type, or metadata.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the API key (must be UUID format from publishable/secret type keys, not legacy key names like 'anon' or 'service\_role'). You can get this ID from the List Project API Keys action.
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> **reveal** `boolean`
>
> If true, reveals the full API key value in the response. If false or omitted, secret key values will be partially redacted. Per Supabase's security model, secrets are hidden by default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project API keys
>
> **Slug:** `SUPABASE_GET_PROJECT_API_KEYS`
>
> Retrieves all API keys for an existing Supabase project, specified by its unique reference ID (`ref`); this is a read-only operation.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action. The project must belong to the authenticated user.
>
> **reveal** `boolean`
>
> If true, reveals the full API key values in the response. If false or omitted, secret key values will be partially redacted. Per Supabase's security model, secrets are hidden by default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project config
>
> **Slug:** `SUPABASE_GET_PROJECT_CONFIG`
>
> Retrieve a project's consolidated effective database, pooler, Auth, Data API, Realtime, and Storage configuration. This Supabase Management API endpoint is Alpha and currently supports Personal Access Tokens (PATs) only; Supabase OAuth access tokens are not supported.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Twenty-letter lowercase Supabase project reference.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Disk Autoscale Config
>
> **Slug:** `SUPABASE_GET_PROJECT_DISK_AUTOSCALE_CONFIG`
>
> Get disk autoscale configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Function Combined Stats
>
> **Slug:** `SUPABASE_GET_PROJECT_FUNCTION_COMBINED_STATS`
>
> Get combined function statistics.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **interval** `string ("15min" | "1hr" | "3hr" | "1day")` *required*
>
> Documented query parameter interval.
>
> **function\_id** `string` *required*
>
> Documented query parameter function\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project legacy API keys status
>
> **Slug:** `SUPABASE_GET_PROJECT_LEGACY_API_KEYS`
>
> Deprecated by the provider; no sunset date or replacement is announced. Checks whether JWT-based legacy API keys (anon, service\_role) are enabled. The endpoint may return HTTP 404 when unavailable. Behavior is unchanged.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action. The project must belong to the authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project logs
>
> **Slug:** `SUPABASE_GET_PROJECT_LOGS`
>
> Retrieves the unified logs stream for a Supabase project, including database, API, and edge function logs, for monitoring and debugging. Custom queries use ClickHouse SQL against the logs table, filtering by source; legacy source tables and metadata joins must be migrated. Provide both UTC timestamps for a time window; Supabase documents a last-minute fallback without both and a maximum 24-hour range. Check the response's error field even when execution reports success. Returned row fields depend on the query.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> **sql** `string`
>
> Optional ClickHouse SQL query against the unified logs table. For example: SELECT timestamp, event\_message FROM logs WHERE source = 'postgres\_logs' ORDER BY timestamp DESC LIMIT 100. Legacy source tables such as edge\_logs and postgres\_logs are no longer queried directly; filter the source column instead. Access nested attributes with log\_attributes\['key'], not metadata joins. Queries are passed through unchanged. Check the response's error field even when the tool reports success.
>
> **iso\_timestamp\_end** `string`
>
> End of the log query window as a UTC ISO 8601 timestamp, e.g., '2026-10-06T14:00:00Z'. Provide with iso\_timestamp\_start and keep end after start. Supabase documents a maximum 24-hour range and rounding to the nearest minute; without both timestamps it documents a last-1-minute fallback. Values are passed through; this tool does not validate the range.
>
> **iso\_timestamp\_start** `string`
>
> Start of the log query window as a UTC ISO 8601 timestamp, e.g., '2026-10-06T13:00:00Z'. Provide both start and end to select a window; otherwise the provider documents a last-1-minute fallback. Supabase documents rounding to the nearest minute and a maximum 24-hour range. Values are passed through; this tool does not validate the range.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project metrics
>
> **Slug:** `SUPABASE_GET_PROJECT_METRICS`
>
> Retrieve a Supabase project's Prometheus/OpenMetrics exposition.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique 20-character reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project PgBouncer config
>
> **Slug:** `SUPABASE_GET_PROJECT_PGBOUNCER_CONFIG`
>
> Retrieves the active PgBouncer configuration (PostgreSQL connection pooler) for a Supabase project, used for performance tuning, auditing, or getting the connection string.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project postgres config
>
> **Slug:** `SUPABASE_GET_PROJECT_POSTGRES_CONFIG`
>
> Retrieves the current read-only PostgreSQL database configuration for a specified Supabase project's `ref`, noting that some advanced or security-sensitive details might be omitted from the response.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project's PostgREST config
>
> **Slug:** `SUPABASE_GET_PROJECT_POSTGREST_CONFIG`
>
> Retrieves the PostgREST configuration for a specific Supabase project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project's read-only mode status
>
> **Slug:** `SUPABASE_GET_PROJECT_READONLY_MODE_STATUS`
>
> Retrieves the read-only mode status for a specified Supabase project to check its operational state; this action does not change the read-only state.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project reference ID, found in your project's dashboard URL (e.g., `https://supabase.com/dashboard/project/<project-ref>`).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project signing keys
>
> **Slug:** `SUPABASE_GET_PROJECT_SIGNING_KEYS`
>
> Tool to list all signing keys for a Supabase project. Use when you need to retrieve JWT signing keys for authentication verification or rotation management.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project Supavisor configuration
>
> **Slug:** `SUPABASE_GET_PROJECT_SUPAVISOR_CONFIG`
>
> Retrieves the Supavisor (connection pooler) configuration for a specified Supabase project, identified by its reference ID.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Upgrade Eligibility
>
> **Slug:** `SUPABASE_GET_PROJECT_UPGRADE_ELIGIBILITY`
>
> Checks a Supabase project's eligibility for an upgrade, verifying compatibility and identifying potential issues; this action does not perform the actual upgrade.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique identifier of the Supabase project (e.g., 'opntiysxcrktmaarzjhz'). Can be obtained from the Supabase dashboard URL or by listing all projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project upgrade status
>
> **Slug:** `SUPABASE_GET_PROJECT_UPGRADE_STATUS`
>
> Retrieves the latest status of a Supabase project's database upgrade for monitoring purposes; does not initiate or modify upgrades.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Usage Api Count
>
> **Slug:** `SUPABASE_GET_PROJECT_USAGE_API_COUNT`
>
> Get project usage API counts.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **interval** `string ("15min" | "30min" | "1hr" | "3hr" | "1day" | "3day" | "7day")`
>
> Documented query parameter interval.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Usage Request Count
>
> **Slug:** `SUPABASE_GET_PROJECT_USAGE_REQUEST_COUNT`
>
> Get project usage API request counts.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Public Image Headers
>
> **Slug:** `SUPABASE_GET_PUBLIC_IMAGE_HEADERS`
>
> Get public image transformation headers.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **download** `string`
>
> Documented query parameter download.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Public Object Headers
>
> **Slug:** `SUPABASE_GET_PUBLIC_OBJECT_HEADERS`
>
> Get public object information headers.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Public Object Info
>
> **Slug:** `SUPABASE_GET_PUBLIC_OBJECT_INFO`
>
> Get public object information.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Realtime Config
>
> **Slug:** `SUPABASE_GET_REALTIME_CONFIG`
>
> Get Realtime configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get TUS resumable upload base options
>
> **Slug:** `SUPABASE_GET_RESUMABLE_UPLOAD_BASE_OPTIONS`
>
> Handles OPTIONS request for TUS Resumable uploads to discover server capabilities. Use when preparing resumable upload requests to verify supported TUS protocol versions and extensions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get TUS resumable upload options
>
> **Slug:** `SUPABASE_GET_RESUMABLE_UPLOAD_OPTIONS`
>
> Handles OPTIONS request for TUS Resumable uploads to discover server capabilities. Use when preparing resumable upload requests to verify supported TUS protocol versions and extensions.
>
> #### Input Parameters
>
> **wildcard** `string` *required*
>
> The wildcard path parameter representing the upload ID or file path for the TUS resumable upload. Used to identify the specific upload resource for CORS preflight requests.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Resumable Upload Status
>
> **Slug:** `SUPABASE_GET_RESUMABLE_UPLOAD_STATUS`
>
> Get resumable upload offset and metadata. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Resumable Upload Status Signed
>
> **Slug:** `SUPABASE_GET_RESUMABLE_UPLOAD_STATUS_SIGNED`
>
> Get signed resumable upload offset and metadata. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **x\_signature** `string` *required*
>
> Signed upload token from SUPABASE\_CREATE\_SIGNED\_UPLOAD\_URL; forwarded only to this project Storage endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Security Advisors
>
> **Slug:** `SUPABASE_GET_SECURITY_ADVISORS`
>
> Retrieves security advisor findings and recommendations for a Supabase project. Use when you need to audit project security posture, identify SQL-based security issues, or get remediation guidance. Note: This endpoint is deprecated and may be removed in future API versions.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> **lint\_type** `string ("sql")`
>
> Type of linting to perform for security advisors.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Signed Image Headers
>
> **Slug:** `SUPABASE_GET_SIGNED_IMAGE_HEADERS`
>
> Get signed image transformation headers.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Documented query parameter token.
>
> **download** `string`
>
> Documented query parameter download.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Signed Object Headers
>
> **Slug:** `SUPABASE_GET_SIGNED_OBJECT_HEADERS`
>
> Get headers for a presigned object retrieval.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Documented query parameter token.
>
> **download** `string`
>
> Documented query parameter download.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project's auth config
>
> **Slug:** `SUPABASE_GETS_PROJECT_S_AUTH_CONFIG`
>
> Retrieves a project's authentication configuration, including provider, MFA, email, SMS, JWT and security settings. The response can contain sensitive secrets.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Can also be provided as 'project\_ref'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project's service health status
>
> **Slug:** `SUPABASE_GETS_PROJECT_S_SERVICE_HEALTH_STATUS`
>
> Retrieves the current health status for a Supabase project, for specified services or all services if the 'services' list is omitted.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier (ref) of the Supabase project.
>
> **services** `array`
>
> A list of specific services for which to retrieve health status. If omitted, returns health status for all services. Valid values: auth, db, db\_postgres\_user, pg\_bouncer, pooler, realtime, rest, storage.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a specific SQL snippet
>
> **Slug:** `SUPABASE_GET_SQL_SNIPPET`
>
> Retrieves a specific SQL snippet by its unique identifier.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the SQL snippet to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a SSO provider by its UUID
>
> **Slug:** `SUPABASE_GET_SSO_PROVIDER`
>
> Retrieves configuration details for a project's SAML Single Sign-On provider by UUID.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **provider\_id** `string` *required*
>
> The unique identifier (UUID) of the SSO provider whose configuration is to be fetched.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Bucket
>
> **Slug:** `SUPABASE_GET_STORAGE_BUCKET`
>
> Get bucket details. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Bucket Headers
>
> **Slug:** `SUPABASE_GET_STORAGE_BUCKET_HEADERS`
>
> Get bucket response headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Bucket List Headers
>
> **Slug:** `SUPABASE_GET_STORAGE_BUCKET_LIST_HEADERS`
>
> Get bucket-list response headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Documented query parameter limit.
>
> **offset** `integer`
>
> Documented query parameter offset.
>
> **search** `string`
>
> Documented query parameter search.
>
> **sort\_order** `string ("asc" | "desc")`
>
> Documented query parameter sortOrder.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **sort\_column** `string ("id" | "name" | "created_at" | "updated_at")`
>
> Documented query parameter sortColumn.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Config
>
> **Slug:** `SUPABASE_GET_STORAGE_CONFIG`
>
> Get project Storage configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Health
>
> **Slug:** `SUPABASE_GET_STORAGE_HEALTH`
>
> Check the Storage service health, distinct from Management API health.
>
> #### Input Parameters
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Health Headers
>
> **Slug:** `SUPABASE_GET_STORAGE_HEALTH_HEADERS`
>
> Get Storage service health response headers.
>
> #### Input Parameters
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Object Headers
>
> **Slug:** `SUPABASE_GET_STORAGE_OBJECT_HEADERS`
>
> Retrieve object information headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Object Info
>
> **Slug:** `SUPABASE_GET_STORAGE_OBJECT_INFO`
>
> Retrieve object information. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Storage Object Info Headers
>
> **Slug:** `SUPABASE_GET_STORAGE_OBJECT_INFO_HEADERS`
>
> Get object information headers. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Table Schemas
>
> **Slug:** `SUPABASE_GET_TABLE_SCHEMAS`
>
> Retrieve column details, types, primary and unique constraints, and optionally foreign keys for multiple database tables. Some returned metadata uses placeholders, and index information is not fetched.
>
> #### Input Parameters
>
> **project\_ref** `string` *required*
>
> The unique reference ID of the Supabase project. This is visible in your Supabase project URL (e.g., [https://supabase.com/dashboard/project/\&#123;project\_ref\&#125](https://supabase.com/dashboard/project/\&#123;project_ref\&#125);).
>
> **table\_names** `array` *required*
>
> List of table names to retrieve schemas for. At least one table name is required (empty lists are not allowed). Tables can be from different schemas (e.g., 'public.users', 'operations.call\_queue\_items'). Without schema prefix, 'public' is assumed. Maximum 20 tables per request.
>
> **include\_indexes** `boolean`
>
> Whether to include index information in the response
>
> **exclude\_null\_values** `boolean`
>
> Whether to exclude properties with null values from the response for cleaner output
>
> **include\_relationships** `boolean`
>
> Whether to include foreign key relationships in the response
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] OPTIONS for resumable upload sign
>
> **Slug:** `SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONS`
>
> Send an OPTIONS request to the TUS resumable upload signing endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] OPTIONS for resumable upload sign
>
> **Slug:** `SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONS_WITH_ID`
>
> Send an OPTIONS request to a TUS resumable upload signing endpoint for a specified path.
>
> #### Input Parameters
>
> **wildcard** `string` *required*
>
> The full path to the object for resumable upload signing, typically in format 'bucket-name/path/to/file'. This wildcard path segment is used for CORS preflight OPTIONS requests before the actual upload signing request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Insert Table Rows
>
> **Slug:** `SUPABASE_INSERT_TABLE_ROWS`
>
> Insert rows or upsert on primary/UNIQUE keys in an exposed table or view. Uses a secret or service\_role project key and bypasses Row Level Security. OAuth needs secrets:read; fine-grained PATs need api\_gateway\_keys\_read and api\_gateway\_keys\_secret\_read to reveal project keys. Upserts can overwrite data.
>
> #### Input Parameters
>
> **rows** `string` *required*
>
> One JSON row object or an array of row objects. For bulk inserts use matching keys, or specify columns to allow missing keys.
>
> **count** `string ("exact" | "planned" | "estimated")`
>
> Optional affected-row count strategy; exact can be slower.
>
> **table** `string` *required*
>
> Exposed table or writable view name, without a schema prefix.
>
> **schema** `string`
>
> Exposed database schema. Omit to use the project's default schema.
>
> **select** `string`
>
> PostgREST projection or embedded resources for return=representation.
>
> **columns** `string`
>
> PostgREST comma-separated payload columns to insert; other keys are ignored.
>
> **missing** `string`
>
> Use database defaults for missing payload columns instead of null.
>
> **resolution** `string ("merge-duplicates" | "ignore-duplicates")`
>
> Enable upsert by merging conflicting rows or ignoring duplicates.
>
> **on\_conflict** `string`
>
> Comma-separated UNIQUE columns to use for upsert conflict detection.
>
> **project\_ref** `string` *required*
>
> Unique 20-character lowercase reference ID of the Supabase project.
>
> **return\_preference** `string ("representation" | "minimal")`
>
> Return affected rows or no body. Omit for the provider default (minimal).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Invite External Jit Access
>
> **Slug:** `SUPABASE_INVITE_EXTERNAL_JIT_ACCESS`
>
> Invite an external user for JIT database access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Invoke Database Function
>
> **Slug:** `SUPABASE_INVOKE_DATABASE_FUNCTION`
>
> Invoke a known exposed Postgres function with named JSON arguments. Supports custom exposed schemas and table-valued result selection, filters, ordering, pagination, and counts. The function runs with a service-role project key that bypasses Row Level Security and may create, update, or delete data or execute DDL.
>
> #### Input Parameters
>
> **count** `string ("exact" | "planned" | "estimated")`
>
> Optional PostgREST count strategy for a table-valued function. Exact counts may be slower on large results.
>
> **limit** `integer`
>
> Maximum rows to return from a table-valued function; use 0 to return no rows while requesting a count.
>
> **order** `string`
>
> PostgREST ordering expression for a table-valued result.
>
> **offset** `integer`
>
> Rows to skip before returning a table-valued function page.
>
> **schema** `string`
>
> Exposed database schema containing the function. Omit to use the project's default exposed schema, usually public.
>
> **select** `string`
>
> Columns and embedded resources to return from a table-valued function, using PostgREST select syntax.
>
> **filters** `object`
>
> Filters for a table-valued function, mapping each column or embedded field to a PostgREST expression such as \{'rating': 'gt.8'}.
>
> **arguments** `object`
>
> Named function arguments as a JSON object; omit for a function without arguments.
>
> **project\_ref** `string` *required*
>
> Unique 20-character reference ID of the Supabase project.
>
> **function\_name** `string` *required*
>
> Name of the exposed Postgres function to invoke.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Invoke Edge Function
>
> **Slug:** `SUPABASE_INVOKE_EDGE_FUNCTION`
>
> Tool to invoke a deployed Supabase Edge Function over HTTPS. Use for testing and debugging Edge Functions with configurable method, headers, body, and authentication.
>
> #### Input Parameters
>
> **body** `string`
>
> Request body to send to the function. Can be a JSON object (dict) or a raw string.
>
> **method** `string ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")`
>
> HTTP method to use when invoking the function.
>
> **headers** `object`
>
> Optional additional headers to send with the request (e.g., Content-Type).
>
> **auth\_mode** `string ("anon" | "service_role" | "custom_bearer")`
>
> Authorization mode: 'anon' uses the anon key, 'service\_role' uses the service role key, 'custom\_bearer' requires a custom Authorization header in the headers parameter.
>
> **project\_ref** `string` *required*
>
> Unique reference ID of the Supabase project (used in the hostname).
>
> **function\_slug** `string` *required*
>
> Name/slug of the Edge Function to invoke.
>
> **response\_type** `string ("json" | "text" | "auto")`
>
> Expected response format: 'json' parses as JSON, 'text' returns raw text, 'auto' attempts JSON first then falls back to text.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Invoke Read Only Function
>
> **Slug:** `SUPABASE_INVOKE_READ_ONLY_FUNCTION`
>
> Invoke a known exposed Postgres function using GET in a read-only transaction. Not an Edge Function or arbitrary SQL executor. Database writes are rejected by PostgREST's GET transaction mode. Uses a secret/service\_role key that bypasses Row Level Security, so reads can expose all rows. External side effects of a function are not prevented by a database read-only transaction. Supports table-valued projection, filters, ordering, pagination, and counts. OAuth needs secrets:read; fine-grained PATs need api\_gateway\_keys\_read and api\_gateway\_keys\_secret\_read to reveal project keys.
>
> #### Input Parameters
>
> **count** `string ("exact" | "planned" | "estimated")`
>
> Optional row count strategy. Exact counts can be slow on large results.
>
> **limit** `integer`
>
> Maximum rows; 0 requests no rows, useful with count.
>
> **order** `string`
>
> PostgREST ordering expression, e.g. created\_at.desc.
>
> **offset** `integer`
>
> Number of table-valued result rows to skip.
>
> **schema** `string`
>
> Exposed schema for Accept-Profile; omit for the project default.
>
> **select** `string`
>
> PostgREST column projection and embedding for a table-valued result.
>
> **filters** `object`
>
> Table-valued result filters, e.g. \{'rating': 'gt.8'}. Keys must not collide with arguments or select/order/limit/offset/count/columns/on\_conflict.
>
> **arguments** `object`
>
> Named arguments as strings in PostgreSQL input format, not SQL expressions. Use '42' for an integer, 'true' for a boolean, raw text without SQL quotes, and '\{1,2}' for a PostgreSQL array (not '\[1,2]'). For json/jsonb parameters supply JSON text. Supply unencoded values; the transport URL-encodes them. Omit defaulted arguments. Repeated variadic parameters and unnamed arguments are not supported. Names must not collide with filters or query controls.
>
> **project\_ref** `string` *required*
>
> Unique 20-character lowercase Supabase project reference.
>
> **function\_name** `string` *required*
>
> Name of the exposed Postgres function, without a schema prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Action Runs
>
> **Slug:** `SUPABASE_LIST_ACTION_RUNS`
>
> List one page of action runs for a project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **limit** `number`
>
> Documented query parameter limit.
>
> **offset** `number`
>
> Documented query parameter offset.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all organizations
>
> **Slug:** `SUPABASE_LIST_ALL_ORGANIZATIONS`
>
> Lists organizations associated with the authenticated Supabase account, returning their IDs, slugs, and names.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all projects
>
> **Slug:** `SUPABASE_LIST_ALL_PROJECTS`
>
> Lists Supabase projects for the authenticated user, including project ID, name, organization ID, region, status, database information, and creation time. OAuth access requires the projects:read scope.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List project database backups
>
> **Slug:** `SUPABASE_LIST_BACKUPS`
>
> Lists all database backups for a Supabase project, providing details on existing backups but not creating new ones or performing restores; availability may depend on plan and configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier (reference string) of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List database branches
>
> **Slug:** `SUPABASE_LIST_BRANCHES`
>
> Lists all database branches for a specified Supabase project, providing information about each branch's status, configuration, and metadata. Use this action when you need to view all branches in a project, check branch statuses, or identify available branches before performing operations. Database branches are useful for isolated development and testing of schema changes.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference identifier (project ref) of the Supabase project. This ID can be found in your project's dashboard URL.
>
> **limit** `integer`
>
> Maximum number of branches to return per request. Defaults to 25.
>
> **offset** `integer`
>
> Number of branches to skip before returning results. Use for pagination.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all buckets
>
> **Slug:** `SUPABASE_LIST_BUCKETS`
>
> Retrieves a list of all storage buckets for a Supabase project, without returning bucket contents or access policies.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all database branches
>
> **Slug:** `SUPABASE_LIST_DATABASE_BRANCHES`
>
> Lists all database branches for a specified Supabase project, used for isolated development and testing of schema changes; ensure the project reference ID is valid.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier (reference ID) of the Supabase project. This ID can be found in your project's dashboard URL (e.g., `https://supabase.com/dashboard/project/<project_id>`).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all functions
>
> **Slug:** `SUPABASE_LIST_FUNCTIONS`
>
> Lists metadata for all Edge Functions in a Supabase project (specified by 'ref'), excluding function code or logs; the project must exist.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Jit Access
>
> **Slug:** `SUPABASE_LIST_JIT_ACCESS`
>
> List all user-to-role mappings for JIT access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List migration history
>
> **Slug:** `SUPABASE_LIST_MIGRATION_HISTORY`
>
> Retrieves the list of applied database migration versions for a Supabase project. Use this to track which migrations have been applied to the project's database. This is a read-only operation that requires the project reference ID.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action. The project must belong to the authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List members of an organization
>
> **Slug:** `SUPABASE_LIST_ORGANIZATION_MEMBERS`
>
> Retrieves all members of a Supabase organization, identified by its unique slug, including their user ID, username, email, role, and MFA status.
>
> #### Input Parameters
>
> **slug** `string` *required*
>
> The unique identifier (slug) of the organization for which to list members.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Projects
>
> **Slug:** `SUPABASE_LIST_ORGANIZATION_PROJECTS`
>
> List one page of projects for an organization.
>
> #### Input Parameters
>
> **slug** `string` *required*
>
> Organization slug
>
> **sort** `string ("name_asc" | "name_desc" | "created_asc" | "created_desc")`
>
> Sort order for projects
>
> **limit** `integer`
>
> Number of projects to return per page
>
> **offset** `integer`
>
> Number of projects to skip
>
> **search** `string`
>
> Search projects by name
>
> **statuses** `string`
>
> A comma-separated list of project statuses to filter by.  The following values are supported: `ACTIVE_HEALTHY`, `INACTIVE`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Project Addons
>
> **Slug:** `SUPABASE_LIST_PROJECT_ADDONS`
>
> List billing addons and compute instance selections. Changes may affect billing; inspect the project plan before modifying addons.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Project Restore Versions
>
> **Slug:** `SUPABASE_LIST_PROJECT_RESTORE_VERSIONS`
>
> List available restore versions for a project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List project secrets
>
> **Slug:** `SUPABASE_LIST_PROJECT_SECRETS`
>
> Retrieves all secrets (environment variables) for a Supabase project by its reference ID. Use this action when you need to view the secrets configured for a project, such as API keys, database URLs, or other environment variables. Note that secret values in the response may be masked for security reasons.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (ref) of the Supabase project whose secrets you want to list. This is a 20-character alphanumeric identifier visible in your project dashboard URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all secrets
>
> **Slug:** `SUPABASE_LIST_SECRETS`
>
> Retrieves all secrets for a Supabase project using its reference ID; secret values in the response may be masked.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (ref) of the Supabase project whose secrets are to be retrieved.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List SQL snippets for the logged in user
>
> **Slug:** `SUPABASE_LIST_SQL_SNIPPETS`
>
> Retrieves the first page of SQL snippets for the logged-in user, optionally filtered by Supabase project. The response may contain a pagination cursor, but this tool cannot request subsequent pages.
>
> #### Input Parameters
>
> **project\_ref** `string`
>
> The unique identifier for your Supabase project. It is a 20-digit string used to reference and manage your project in API endpoints. This can be found in Supabase Studio under Settings > General > Project Settings > Reference ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all SSO providers
>
> **Slug:** `SUPABASE_LIST_SSO_PROVIDERS`
>
> Lists all configured Single Sign-On (SSO) providers for a Supabase project, requiring the project reference ID (`ref`) of an existing project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The project's reference ID. Typically found in dashboard settings or the API URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Storage Buckets
>
> **Slug:** `SUPABASE_LIST_STORAGE_BUCKETS`
>
> List Storage buckets through the data-plane API. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Documented query parameter limit.
>
> **offset** `integer`
>
> Documented query parameter offset.
>
> **search** `string`
>
> Documented query parameter search.
>
> **sort\_order** `string ("asc" | "desc")`
>
> Documented query parameter sortOrder.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **sort\_column** `string ("id" | "name" | "created_at" | "updated_at")`
>
> Documented query parameter sortColumn.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Storage Objects
>
> **Slug:** `SUPABASE_LIST_STORAGE_OBJECTS`
>
> Search for objects under a prefix. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Storage Objects V2
>
> **Slug:** `SUPABASE_LIST_STORAGE_OBJECTS_V2`
>
> Search for objects under a prefix using list v2. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Database Tables
>
> **Slug:** `SUPABASE_LIST_TABLES`
>
> Lists tables and optionally views in Supabase database schemas, providing an overview of database structure. Schema discovery can fall back to public, and per-schema failures are reported alongside any partial results.
>
> #### Input Parameters
>
> **schemas** `array`
>
> List of schemas to search for tables (maximum 10). If not provided, lists tables from all non-system schemas. Specify schema names to limit the search to specific schemas.
>
> **project\_ref** `string` *required*
>
> The unique reference ID of the Supabase project. Must be exactly 20 lowercase letters (a-z only, no numbers or hyphens). This is visible in your Supabase project URL (e.g., [https://supabase.com/dashboard/project/\&#123;project\_ref\&#125](https://supabase.com/dashboard/project/\&#123;project_ref\&#125);).
>
> **include\_views** `boolean`
>
> Whether to include views along with tables in the results
>
> **include\_metadata** `boolean`
>
> Whether to include basic metadata like estimated row count and table size
>
> **include\_system\_schemas** `boolean`
>
> Whether to include system schemas (pg\_catalog, information\_schema, etc.) when listing all schemas. When set to false, temporary and internal schemas such as pg\_temp\_*, pg\_toast\_temp\_* and pgbouncer are excluded from the results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge a database branch
>
> **Slug:** `SUPABASE_MERGE_BRANCH`
>
> Initiates a merge of a database branch into its target database. An optional migration version can limit how far migrations are merged; the response identifies the triggered workflow run.
>
> #### Input Parameters
>
> **branch\_id\_or\_ref** `string` *required*
>
> The unique identifier (UUID format) or reference of the database branch to merge.
>
> **migration\_version** `string`
>
> Optional migration version to merge up to. Format: timestamp like '20260216000000'. If not provided, merges all migrations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Modify Database Disk
>
> **Slug:** `SUPABASE_MODIFY_DATABASE_DISK`
>
> Modify database disk configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move Storage Object
>
> **Slug:** `SUPABASE_MOVE_STORAGE_OBJECT`
>
> Move an object. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Oauth Authorize Project Claim
>
> **Slug:** `SUPABASE_OAUTH_AUTHORIZE_PROJECT_CLAIM`
>
> Initiate OAuth authorization to claim a project. Returns redirect responses without following them; continue the browser flow using headers.location. An authorization redirect does not prove the claim has completed.
>
> #### Input Parameters
>
> **state** `string`
>
> Documented query parameter state.
>
> **client\_id** `string` *required*
>
> Documented query parameter client\_id.
>
> **project\_ref** `string` *required*
>
> Project ref
>
> **redirect\_uri** `string` *required*
>
> Documented query parameter redirect\_uri.
>
> **response\_mode** `string`
>
> Documented query parameter response\_mode.
>
> **response\_type** `string ("code" | "token" | "id_token token")` *required*
>
> Documented query parameter response\_type.
>
> **code\_challenge** `string`
>
> Documented query parameter code\_challenge.
>
> **code\_challenge\_method** `string ("plain" | "sha256" | "S256")`
>
> Documented query parameter code\_challenge\_method.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch a migration
>
> **Slug:** `SUPABASE_PATCH_MIGRATION`
>
> \[Beta] Patches an existing entry in the project's migration history, updating the name or rollback script. Use this to correct migration metadata after the migration has been created.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project (used in the URL path). Must be exactly 20 lowercase letters (a-z).
>
> **name** `string`
>
> New name for the migration entry. Updates the display name in migration history.
>
> **version** `string` *required*
>
> The version identifier of the migration to patch (typically a timestamp like '20260216042751'). This is found in the migration history.
>
> **rollback** `string`
>
> SQL rollback script for the migration. Defines how to revert the migration changes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch project network restrictions
>
> **Slug:** `SUPABASE_PATCH_NETWORK_RESTRICTIONS`
>
> Updates project's network restrictions by incrementally adding or removing IPv4/IPv6 CIDR blocks. Use when you need to modify existing restrictions without replacing the entire configuration.
>
> #### Input Parameters
>
> **add** `object`
>
> Modification request for adding or removing network restriction CIDRs.
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project (visible in project URL).
>
> **remove** `object`
>
> Modification request for adding or removing network restriction CIDRs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Pause Project
>
> **Slug:** `SUPABASE_PAUSE_PROJECT`
>
> Pause a project, making its services unavailable until it is restored.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post Resumable Upload
>
> **Slug:** `SUPABASE_POST_RESUMABLE_UPLOAD`
>
> Create a TUS upload through the wildcard creation route (an alias of base POST). Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **file** `object`
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> **upload\_length** `integer` *required*
>
> Total upload size in bytes, per the TUS creation extension.
>
> **upload\_metadata** `string` *required*
>
> Comma-separated TUS key base64(value) pairs including bucketName, objectName and contentType.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post Resumable Upload Signed
>
> **Slug:** `SUPABASE_POST_RESUMABLE_UPLOAD_SIGNED`
>
> Create a signed TUS upload through the wildcard creation route (an alias of base POST). Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **file** `object`
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **x\_signature** `string` *required*
>
> Signed upload token from SUPABASE\_CREATE\_SIGNED\_UPLOAD\_URL; forwarded only to this project Storage endpoint.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> **upload\_length** `integer` *required*
>
> Total upload size in bytes, per the TUS creation extension.
>
> **upload\_metadata** `string` *required*
>
> Comma-separated TUS key base64(value) pairs including bucketName, objectName and contentType.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Purge Bucket Cache
>
> **Slug:** `SUPABASE_PURGE_BUCKET_CACHE`
>
> Purge cache for a bucket or its transformations. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **transformations** `boolean`
>
> Documented query parameter transformations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Purge Object Cache
>
> **Slug:** `SUPABASE_PURGE_OBJECT_CACHE`
>
> Purge cache for an object or its transformations. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **transformations** `boolean`
>
> Documented query parameter transformations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Purge Storage Cache
>
> **Slug:** `SUPABASE_PURGE_STORAGE_CACHE`
>
> Purge cache for the tenant or tenant transformations. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **transformations** `boolean`
>
> Documented query parameter transformations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Push a database branch
>
> **Slug:** `SUPABASE_PUSH_BRANCH`
>
> Pushes a database branch, applying migrations and changes to the specified branch. Use when you need to deploy schema changes or migrations to a database branch.
>
> #### Input Parameters
>
> **branch\_id\_or\_ref** `string` *required*
>
> The unique identifier or reference of the database branch to push.
>
> **migration\_version** `string`
>
> Optional migration version to push to the branch. Format: timestamp like '20260216000000'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Project Addon
>
> **Slug:** `SUPABASE_REMOVE_PROJECT_ADDON`
>
> Remove billing addons or revert compute sizing. Changes may affect billing; inspect the project plan before modifying addons.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **addon\_variant** `string` *required*
>
> Documented path parameter addon\_variant.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Authenticated Image
>
> **Slug:** `SUPABASE_RENDER_AUTHENTICATED_IMAGE`
>
> Render an authenticated image with transformations. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **download** `string`
>
> Documented query parameter download.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Public Image
>
> **Slug:** `SUPABASE_RENDER_PUBLIC_IMAGE`
>
> Render a public image with transformations.
>
> #### Input Parameters
>
> **width** `integer`
>
> Documented query parameter width.
>
> **format** `string ("origin" | "avif" | "webp")`
>
> Documented query parameter format.
>
> **height** `integer`
>
> Documented query parameter height.
>
> **resize** `string ("cover" | "contain" | "fill")`
>
> Documented query parameter resize.
>
> **gravity** `string ("no" | "so" | "ea" | "we" | "noea" | "nowe" | "soea" | "sowe" | "ce" | "sm" | "fp")`
>
> Image gravity. Focal-point gravity (fp) requires both x\_offset and y\_offset in the 0-1 range.
>
> **quality** `integer`
>
> Documented query parameter quality.
>
> **download** `string`
>
> Documented query parameter download.
>
> **x\_offset** `number`
>
> Horizontal gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **y\_offset** `number`
>
> Vertical gravity offset. For directional gravity, values \< 1 are relative and values >= 1 are absolute pixels. For focal-point gravity, must be between 0 and 1.
>
> **version\_id** `string`
>
> Documented query parameter versionId.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Signed Image
>
> **Slug:** `SUPABASE_RENDER_SIGNED_IMAGE`
>
> Render a signed image with transformations.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Documented query parameter token.
>
> **download** `string`
>
> Documented query parameter download.
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Replace Bucket Lifecycle
>
> **Slug:** `SUPABASE_REPLACE_BUCKET_LIFECYCLE`
>
> Replace bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reset a database branch
>
> **Slug:** `SUPABASE_RESET_DATABASE_BRANCH`
>
> Resets an existing Supabase database branch, identified by `branch_id`, to its initial clean state, irreversibly deleting all its current data and schema changes.
>
> #### Input Parameters
>
> **branch\_id** `string` *required*
>
> The unique identifier of the database branch to reset.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restart Project
>
> **Slug:** `SUPABASE_RESTART_PROJECT`
>
> Restart a project, temporarily interrupting its services. Newly provisioned projects must wait ten minutes.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restore Branch
>
> **Slug:** `SUPABASE_RESTORE_BRANCH`
>
> Restore a scheduled branch deletion.
>
> #### Input Parameters
>
> **branch\_id\_or\_ref** `string` *required*
>
> Branch ref or deprecated branch ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restore database PITR backup
>
> **Slug:** `SUPABASE_RESTORE_PITR_BACKUP`
>
> Restores a Supabase project's database to a specific Unix timestamp using Point-in-Time Recovery (PITR), overwriting the current state; requires a paid plan with PITR and physical backups enabled.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique identifier of the Supabase project.
>
> **recovery\_time\_target\_unix** `integer` *required*
>
> Unix timestamp (seconds) for the desired database restoration point.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restore Project
>
> **Slug:** `SUPABASE_RESTORE_PROJECT`
>
> Restore the given project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Rollback Migrations
>
> **Slug:** `SUPABASE_ROLLBACK_MIGRATIONS`
>
> Rollback database migrations and remove them from history.
>
> #### Input Parameters
>
> **gte** `string` *required*
>
> Rollback migrations greater or equal to this version
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute read-only database query
>
> **Slug:** `SUPABASE_RUN_READ_ONLY_QUERY`
>
> Run a read-only SQL query against a Supabase project as supabase\_read\_only\_user. This beta endpoint requires all entity references to be schema-qualified.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project (used in the URL path). Must be exactly 20 lowercase letters (a-z). Can be found in Project Settings > General > Reference ID in the Supabase Dashboard, or from the dashboard URL: [https://supabase.com/dashboard/project/\&lt;project-ref](https://supabase.com/dashboard/project/\&lt;project-ref)>. Can also be provided as 'project\_ref'.
>
> **query** `string` *required*
>
> The SQL query to be executed as supabase\_read\_only\_user. Only SELECT and other read-only operations are allowed. Write operations (INSERT, UPDATE, DELETE, CREATE, etc.) will be rejected. Can also be provided as 'sql'. IMPORTANT - Single Quote Handling: DO NOT double or escape single quotes in your SQL. The query is transmitted as a JSON string body, so standard SQL single quotes work directly. For example, write WHERE name = 'John' NOT WHERE name = ''John''.
>
> **parameters** `array`
>
> Optional array of parameters for parameterized queries. Use \$1, \$2, etc. in the query to reference parameters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Select From Table
>
> **Slug:** `SUPABASE_SELECT_FROM_TABLE`
>
> Select rows from a Supabase/PostgREST table or view, with column selection, filtering, sorting, and pagination. When a project API key is not supplied, the tool may use a service-role key, which bypasses row-level security.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of rows to return (must be >= 1)
>
> **order** `string`
>
> Ordering expression in the form `column.asc` or `column.desc`
>
> **table** `string` *required*
>
> Table or view name to select from
>
> **offset** `integer`
>
> Number of rows to skip before returning results (must be >= 0)
>
> **select** `string` *required*
>
> Comma-separated list of columns to return. Supports nested/related selections and JSON path selectors (e.g., address->postcode).
>
> **filters** `array`
>
> Optional list of filters. Each filter will be rendered as `<column>_<operator>=<value>` in the query string (e.g., id\_eq=123). Can be provided as a list of FilterItem objects. Each FilterItem must have: column (string), operator (one of: eq, neq, gt, gte, lt, lte, like, ilike, is, in, cs, cd, sl, sr, nxl, nxr, adj, ov, fts, plfts, phfts, wfts), and value (the comparison value).
>
> **project\_ref** `string` *required*
>
> Unique reference ID of the Supabase project (used in the hostname)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Shutdown Realtime
>
> **Slug:** `SUPABASE_SHUTDOWN_REALTIME`
>
> Shut down the project Realtime service connections, disconnecting active clients.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Terminate Resumable Upload
>
> **Slug:** `SUPABASE_TERMINATE_RESUMABLE_UPLOAD`
>
> Terminate a TUS resumable upload. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Terminate Resumable Upload Signed
>
> **Slug:** `SUPABASE_TERMINATE_RESUMABLE_UPLOAD_SIGNED`
>
> Terminate a signed resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.
>
> #### Input Parameters
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **x\_signature** `string` *required*
>
> Signed upload token from SUPABASE\_CREATE\_SIGNED\_UPLOAD\_URL; forwarded only to this project Storage endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Action Run Status
>
> **Slug:** `SUPABASE_UPDATE_ACTION_RUN_STATUS`
>
> Update the status of an action run.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **run\_id** `string` *required*
>
> Action Run ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a function
>
> **Slug:** `SUPABASE_UPDATE_A_FUNCTION`
>
> Updates an existing Supabase Edge Function's properties, including its name, slug, source code, JWT settings, and import map, using its project reference and function slug.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **body** `string`
>
> New source code (e.g., Deno/TypeScript) or base64-encoded ESZIP content for the function, sent in the request body.
>
> **name** `string`
>
> Optional new name for the function. This value is sent in the request body as 'name'.
>
> **slug** `string`
>
> Optional new slug for the function. If provided as a query parameter, this changes the function's access URL.
>
> **import\_map** `boolean`
>
> Whether to use an import map for the function (query parameter).
>
> **verify\_jwt** `boolean`
>
> Specifies whether JWT verification should be enabled. This value is sent in the request body as 'verify\_jwt'.
>
> **function\_slug** `string` *required*
>
> The current slug (unique identifier) of the Edge Function to be updated.
>
> **entrypoint\_path** `string`
>
> Path to the main Deno script for the function (query parameter).
>
> **import\_map\_path** `string`
>
> Path to the import map file (query parameter).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update API key
>
> **Slug:** `SUPABASE_UPDATE_API_KEY`
>
> Updates an existing Supabase project API key's name, description, or JWT template without regenerating the key. It can request that the key value be revealed in the response.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the API key to update (must be UUID format from publishable/secret type keys, not legacy key names like 'anon' or 'service\_role'). You can get this ID from the List Project API Keys or Get Project API Key actions.
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> **name** `string`
>
> New name for the API key. Must be 4-64 characters long and follow the pattern: lowercase letters, numbers, and underscores only, starting with a letter or underscore (e.g., 'my\_api\_key\_2024').
>
> **reveal** `boolean`
>
> If true, reveals the full API key value in the response. If false or omitted, secret key values will be partially redacted. Per Supabase's security model, secrets are hidden by default.
>
> **description** `string`
>
> Optional new description for the API key to help identify its purpose or usage context.
>
> **secret\_jwt\_template** `object`
>
> Template for claims/config associated with JWT-style keys.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Backup Schedule
>
> **Slug:** `SUPABASE_UPDATE_BACKUP_SCHEDULE`
>
> Update the project's backup schedule.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update branch configuration
>
> **Slug:** `SUPABASE_UPDATE_BRANCH`
>
> Updates the configuration of a Supabase database branch, allowing modification of its name, associated Git branch, notification URL, persistence settings, and status. Use this action when you need to modify branch settings after creation, such as linking to a different Git branch, changing the branch name, or updating persistence behavior. Note: Database branching requires a paid Supabase plan (Pro or higher).
>
> #### Input Parameters
>
> **status** `string ("CREATING_PROJECT" | "RUNNING_MIGRATIONS" | "MIGRATIONS_PASSED" | "MIGRATIONS_FAILED" | "FUNCTIONS_DEPLOYED" | "FUNCTIONS_FAILED")`
>
> Status values that can be set when updating a branch.
>
> **git\_branch** `string`
>
> Name of the Git branch to associate with this database branch. If not provided, the association remains unchanged.
>
> **notify\_url** `string`
>
> HTTP endpoint to receive branch status updates. Must be a valid URI.
>
> **persistent** `boolean`
>
> If true, the database branch is persistent; non-persistent branches may be auto-cleaned. If not provided, this setting remains unchanged.
>
> **branch\_name** `string`
>
> New name for the database branch. If not provided, the name remains unchanged.
>
> **reset\_on\_push** `boolean`
>
> This field is deprecated and will be ignored. Use v1-reset-a-branch endpoint directly instead.
>
> **request\_review** `boolean`
>
> If true, requests a review for this branch. If not provided, this setting remains unchanged.
>
> **branch\_id\_or\_ref** `string` *required*
>
> Unique identifier or reference of the database branch to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update database branch config
>
> **Slug:** `SUPABASE_UPDATE_DATABASE_BRANCH_CONFIG`
>
> Updates a Supabase database branch's configuration, including its name, associated Git branch, persistence, and status. The reset-on-push field is deprecated and ignored by Supabase.
>
> #### Input Parameters
>
> **status** `string ("CREATING_PROJECT" | "FUNCTIONS_DEPLOYED" | "FUNCTIONS_FAILED" | "MIGRATIONS_FAILED" | "MIGRATIONS_PASSED" | "RUNNING_MIGRATIONS")`
>
> Status values that can be set when updating a branch.
>
> **branch\_id** `string` *required*
>
> Unique identifier of the database branch to update. Must be exactly 20 lowercase alphabetic characters.
>
> **git\_branch** `string`
>
> Name of the Git branch to associate with this database branch. If not provided, the association remains unchanged.
>
> **persistent** `boolean`
>
> If true, the database branch is persistent; non-persistent branches may be auto-cleaned. If not provided, this setting remains unchanged.
>
> **branch\_name** `string`
>
> New name for the database branch. If not provided, the name remains unchanged.
>
> **reset\_on\_push** `boolean`
>
> If true, resets the database branch on new push to the linked Git branch. If not provided, this setting remains unchanged.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update database password
>
> **Slug:** `SUPABASE_UPDATE_DATABASE_PASSWORD`
>
> Updates the database password for a Supabase project. Use it to rotate credentials or recover database access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **password** `string` *required*
>
> The new database password to set. Must be at least 4 characters long.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk update functions
>
> **Slug:** `SUPABASE_UPDATE_FUNCTIONS`
>
> Bulk updates Edge Functions in a Supabase project with configurations such as status and version. The operation can create new functions or replace existing ones; version increments must be supplied manually.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Supabase project reference ID.
>
> **functions** `array` *required*
>
> List of functions to update. Each function must have id, slug, name, status, and version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Jit Access
>
> **Slug:** `SUPABASE_UPDATE_JIT_ACCESS`
>
> Update a user mapping for JIT access.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update JIT access config
>
> **Slug:** `SUPABASE_UPDATE_JIT_ACCESS_CONFIG`
>
> \[Beta] Update a Supabase project's just-in-time (JIT) access configuration. Use to enable or disable JIT access features for privileged operations on the project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project.
>
> **state** `string ("enabled" | "disabled" | "unavailable")` *required*
>
> Desired just-in-time access state for the project. 'enabled' activates JIT access, 'disabled' deactivates it, 'unavailable' marks the feature as unavailable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update pgsodium root key
>
> **Slug:** `SUPABASE_UPDATE_PGSODIUM_CONFIG`
>
> Updates a Supabase project's pgsodium root encryption key. Changing the root key can make data encrypted with the previous key inaccessible.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier (ref ID) of the Supabase project.
>
> **root\_key** `string` *required*
>
> The new root encryption key for pgsodium. Must be a cryptographically strong key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a project
>
> **Slug:** `SUPABASE_UPDATE_PROJECT`
>
> Updates a Supabase project's configuration (currently supports updating the project name). Use when you need to rename an existing project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project reference identifier (unique identifier for the project). This is typically a 20-character alphanumeric string found in your project URL or via the List All Projects endpoint.
>
> **name** `string` *required*
>
> New name for the project. Must be between 1 and 256 characters. This is the human-readable display name that will appear in the Supabase dashboard.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update project's auth config
>
> **Slug:** `SUPABASE_UPDATE_PROJECT_AUTH_CONFIG`
>
> Update Supabase project Auth configuration via the Management API. Use to fix misconfigured Auth redirects, SMTP settings, or other auth parameters. Only provided fields are updated; others remain unchanged. Before updating, confirm the Auth service status is ACTIVE\_HEALTHY by checking project health.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project. Can also be provided as 'project\_ref'.
>
> **jwt\_exp** `integer`
>
> JWT access token expiration time in seconds.
>
> **site\_url** `string`
>
> Primary site URL used in email links and redirects. Critical for Auth redirect flows.
>
> **smtp\_host** `string`
>
> SMTP server host for sending auth emails.
>
> **smtp\_pass** `string`
>
> SMTP password for authentication.
>
> **smtp\_port** `integer`
>
> SMTP server port.
>
> **smtp\_user** `string`
>
> SMTP username for authentication.
>
> **disable\_signup** `boolean`
>
> Disable new signups via email/password and OAuth providers.
>
> **mailer\_otp\_exp** `integer`
>
> Email OTP expiration time in seconds.
>
> **uri\_allow\_list** `string`
>
> Comma-separated allowlist of redirect URIs/patterns for OAuth callbacks.
>
> **sessions\_timebox** `integer`
>
> Maximum session lifetime in seconds. 0 means disabled.
>
> **smtp\_admin\_email** `string`
>
> Admin email address used as the sender for SMTP notifications.
>
> **smtp\_sender\_name** `string`
>
> Display name for the SMTP sender.
>
> **mailer\_otp\_length** `integer`
>
> Email OTP length (number of digits).
>
> **rate\_limit\_verify** `integer`
>
> Rate limit for verification attempts (generic).
>
> **external\_azure\_url** `string`
>
> Azure OAuth issuer or discovery URL.
>
> **mailer\_autoconfirm** `boolean`
>
> Automatically confirm new signups (no email confirmation required).
>
> **smtp\_max\_frequency** `integer`
>
> Rate limit for SMTP sends (emails per minute).
>
> **password\_min\_length** `integer`
>
> Minimum required password length.
>
> **rate\_limit\_sms\_sent** `integer`
>
> Rate limit for sending SMS (messages per minute).
>
> **external\_apple\_secret** `string`
>
> Apple OAuth client secret.
>
> **external\_azure\_secret** `string`
>
> Azure OAuth client secret.
>
> **password\_hibp\_enabled** `boolean`
>
> Enable HaveIBeenPwned check during password set/change.
>
> **rate\_limit\_email\_sent** `integer`
>
> Rate limit for sending emails (emails per minute).
>
> **external\_apple\_enabled** `boolean`
>
> Enable Apple as an external OAuth provider.
>
> **external\_azure\_enabled** `boolean`
>
> Enable Azure as an external OAuth provider.
>
> **external\_email\_enabled** `boolean`
>
> Enable email sign-in/up.
>
> **external\_github\_secret** `string`
>
> GitHub OAuth client secret.
>
> **external\_google\_secret** `string`
>
> Google OAuth client secret.
>
> **external\_phone\_enabled** `boolean`
>
> Enable phone (SMS) sign-in/up.
>
> **external\_github\_enabled** `boolean`
>
> Enable GitHub as an external OAuth provider.
>
> **external\_google\_enabled** `boolean`
>
> Enable Google as an external OAuth provider.
>
> **mfa\_totp\_enroll\_enabled** `boolean`
>
> Enable enrolling TOTP as an MFA factor.
>
> **mfa\_totp\_verify\_enabled** `boolean`
>
> Enable TOTP verification as MFA.
>
> **security\_captcha\_secret** `string`
>
> CAPTCHA provider secret key.
>
> **external\_apple\_client\_id** `string`
>
> Apple OAuth client ID.
>
> **external\_azure\_client\_id** `string`
>
> Azure OAuth client ID.
>
> **mfa\_max\_enrolled\_factors** `integer`
>
> Maximum number of MFA factors a user can enroll.
>
> **security\_captcha\_enabled** `boolean`
>
> Enable CAPTCHA verification for risky flows.
>
> **sessions\_single\_per\_user** `boolean`
>
> Restrict to a single active session per user.
>
> **external\_github\_client\_id** `string`
>
> GitHub OAuth client ID.
>
> **external\_google\_client\_id** `string`
>
> Google OAuth client ID.
>
> **security\_captcha\_provider** `string`
>
> CAPTCHA provider (e.g., hcaptcha, turnstile).
>
> **rate\_limit\_anonymous\_users** `integer`
>
> Rate limit for anonymous users (requests per minute).
>
> **sessions\_inactivity\_timeout** `integer`
>
> Session inactivity timeout in seconds. 0 means disabled.
>
> **password\_required\_characters** `string`
>
> Character class requirements for passwords (e.g., regex or flags).
>
> **refresh\_token\_rotation\_enabled** `boolean`
>
> Enable refresh token rotation to reduce token replay risk.
>
> **security\_manual\_linking\_enabled** `boolean`
>
> Enable manual linking of identities to accounts.
>
> **external\_anonymous\_users\_enabled** `boolean`
>
> Enable creation of anonymous users (no credentials).
>
> **mailer\_secure\_email\_change\_enabled** `boolean`
>
> Require secure email change flow (confirm both old and new emails).
>
> **security\_refresh\_token\_reuse\_interval** `integer`
>
> Allowed reuse interval (seconds) for rotated refresh tokens.
>
> **mailer\_allow\_unverified\_email\_sign\_ins** `boolean`
>
> Allow sign-ins from users with unverified emails.
>
> **mailer\_notifications\_email\_changed\_enabled** `boolean`
>
> Enable notification emails when a user's email is changed.
>
> **mailer\_notifications\_phone\_changed\_enabled** `boolean`
>
> Enable notification emails when a phone number is changed.
>
> **mailer\_notifications\_identity\_linked\_enabled** `boolean`
>
> Enable notification emails when an identity is linked.
>
> **mailer\_notifications\_password\_changed\_enabled** `boolean`
>
> Enable notification emails when a password is changed.
>
> **mailer\_notifications\_identity\_unlinked\_enabled** `boolean`
>
> Enable notification emails when an identity is unlinked.
>
> **mailer\_notifications\_mfa\_factor\_enrolled\_enabled** `boolean`
>
> Enable notification emails when an MFA factor is enrolled.
>
> **security\_update\_password\_require\_reauthentication** `boolean`
>
> Require reauthentication before updating password.
>
> **mailer\_notifications\_mfa\_factor\_unenrolled\_enabled** `boolean`
>
> Enable notification emails when an MFA factor is unenrolled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update project's custom hostname configuration
>
> **Slug:** `SUPABASE_UPDATE_PROJECT_CUSTOM_HOSTNAME`
>
> Updates the custom hostname for a Supabase project, requiring subsequent DNS changes for SSL certificate issuance and domain ownership. API errors may be returned in an error message field.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> **custom\_hostname** `string` *required*
>
> Desired custom hostname (e.g., 'api.example.com') to associate with the project's services.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update project legacy API keys
>
> **Slug:** `SUPABASE_UPDATE_PROJECT_LEGACY_API_KEYS`
>
> Deprecated by the provider; no sunset date or replacement is announced. Disable or re-enable JWT-based legacy API keys (anon, service\_role). The endpoint may return HTTP 404 when unavailable. Behavior is unchanged.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID (20 alphanumeric characters) of your Supabase project. You can find this in your project's dashboard URL or by calling the List All Projects action.
>
> **enabled** `boolean` *required*
>
> Enable or disable JWT-based legacy API keys (anon, service\_role). Set to true to enable, false to disable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update project's postgres config
>
> **Slug:** `SUPABASE_UPDATE_PROJECT_POSTGRES_CONFIG`
>
> Updates specified PostgreSQL configuration parameters for an existing Supabase project (`ref`) to optimize database performance; note that unspecified parameters remain unchanged, and caution is advised as incorrect settings can impact stability or require a restart.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project.
>
> **work\_mem** `string`
>
> Memory for internal sorts and hash tables before writing to temp disk files (e.g., '4MB', '64MB').
>
> **max\_wal\_size** `string`
>
> WAL size that triggers a checkpoint (e.g., '1GB', '2048MB').
>
> **wal\_keep\_size** `string`
>
> Minimum size of past WAL log segments in pg\_wal for standby servers (e.g., '128MB', '512MB'); replaces older wal\_keep\_segments.
>
> **shared\_buffers** `string`
>
> Memory for shared memory buffers (e.g., '128MB', '1GB').
>
> **max\_connections** `integer`
>
> Maximum concurrent database connections. Typically between 1 and 262143.
>
> **statement\_timeout** `string`
>
> Maximum allowed duration for any SQL statement (e.g., '10000ms', '30s'); '0' typically disables timeout.
>
> **effective\_cache\_size** `string`
>
> Estimated disk cache size for a single query (e.g., '4GB', '512MB').
>
> **maintenance\_work\_mem** `string`
>
> Maximum memory for maintenance operations like VACUUM, CREATE INDEX (e.g., '64MB', '1GB').
>
> **max\_parallel\_workers** `integer`
>
> Maximum workers the system can support for parallel queries. Typically between 0 and 1024.
>
> **max\_worker\_processes** `integer`
>
> Maximum background processes the system can support. Typically between 0 and 262143.
>
> **max\_slot\_wal\_keep\_size** `string`
>
> Maximum WAL file size replication slots can retain in pg\_wal (e.g., '1GB', '512MB'). '0' might mean unlimited; check PostgreSQL docs.
>
> **session\_replication\_role** `string ("local" | "origin" | "replica")`
>
> Controls firing of replication-related triggers and rules for the current session.
>
> **max\_locks\_per\_transaction** `integer`
>
> Controls the average number of object locks allocated per transaction. Typically between 10 and 2147483640.
>
> **max\_standby\_archive\_delay** `string`
>
> Maximum delay before canceling queries on a hot standby server processing archived WAL data (e.g., '30s', '0ms' to disable).
>
> **max\_standby\_streaming\_delay** `string`
>
> Maximum delay before canceling queries on a hot standby server processing streamed WAL data (e.g., '30s', '0ms' to disable).
>
> **max\_parallel\_workers\_per\_gather** `integer`
>
> Maximum workers for a single Gather or Gather Merge node in a parallel query. Typically between 0 and 1024.
>
> **max\_parallel\_maintenance\_workers** `integer`
>
> Maximum parallel processes for a single maintenance utility command. Typically between 0 and 1024.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update project's PostgREST config
>
> **Slug:** `SUPABASE_UPDATE_PROJECT_POSTGREST_CONFIG`
>
> Updates PostgREST configuration settings (e.g., `max_rows`, `db_pool`, `db_schema`, `db_extra_search_path`) for a Supabase project to fine-tune API performance, data exposure, and database resource usage.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier (reference) of the Supabase project.
>
> **db\_pool** `integer`
>
> The maximum number of connections in the PostgreSQL connection pool for PostgREST. If `null` or not provided, the pool size may be automatically configured based on compute size.
>
> **max\_rows** `integer`
>
> The maximum number of rows PostgREST can return in a single response; this setting helps control payload size and query performance.
>
> **db\_schema** `string`
>
> A comma-separated string of PostgreSQL schemas to be exposed through the PostgREST API (e.g., 'public,api').
>
> **db\_extra\_search\_path** `string`
>
> A comma-separated string of additional PostgreSQL schemas to search for objects if not found in the primary schema(s) defined by `db_schema`. An empty string can be used to clear existing paths.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update database pooler config
>
> **Slug:** `SUPABASE_UPDATE_PROJECT_SUPAVISOR_CONFIG`
>
> Updates Supavisor (database pooler) configuration, including default pool size and pool mode, for an existing Supabase project identified by its reference.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> **pool\_mode** `string ("session" | "transaction")`
>
> This field is deprecated and is ignored in this request. It previously controlled the pooling mode (session or transaction).
>
> **default\_pool\_size** `integer`
>
> Default number of connections per user for the connection pool; helps manage concurrent database connections and performance. Optimal value depends on project's compute add-on size and workload.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Realtime Config
>
> **Slug:** `SUPABASE_UPDATE_REALTIME_CONFIG`
>
> Update Realtime configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update SSL enforcement config
>
> **Slug:** `SUPABASE_UPDATE_SSL_ENFORCEMENT_CONFIG`
>
> Updates the SSL enforcement configuration (enable/disable) for a specified Supabase project's database.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique identifier of the Supabase project.
>
> **requestedConfig\_\_database** `boolean`
>
> Desired SSL enforcement state for the project's database (`true` to enable, `false` to disable).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an SSO provider by its UUID
>
> **Slug:** `SUPABASE_UPDATE_SSO_PROVIDER`
>
> Updates an existing SSO provider's SAML metadata, associated email domains, or attribute mappings for a Supabase project, identified by `ref` and `provider_id`.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Unique reference ID of the Supabase project.
>
> **domains** `array`
>
> Email domains to associate with this SSO provider for user authentication.
>
> **provider\_id** `string` *required*
>
> UUID of the SSO provider to update.
>
> **metadata\_url** `string`
>
> URL pointing to the SAML metadata XML. Use either this or `metadata_xml`.
>
> **metadata\_xml** `string`
>
> SAML metadata XML content from the identity provider. Use either this or `metadata_url`.
>
> **attribute\_\_mapping\_\_keys** `object`
>
> Defines mapping of SAML assertion attributes to Supabase user attributes (e.g., 'email', 'full\_name'). Values specify IdP attribute mapping using 'name', 'names' (for concatenation), or 'default'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Storage Bucket
>
> **Slug:** `SUPABASE_UPDATE_STORAGE_BUCKET`
>
> Update bucket properties. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> **bucket\_id** `string` *required*
>
> Documented path parameter bucketId.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Storage Config
>
> **Slug:** `SUPABASE_UPDATE_STORAGE_CONFIG`
>
> Update project Storage configuration.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project ref
>
> **body** `object` *required*
>
> JSON body for this operation. Only explicitly supplied optional fields are sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Storage Object
>
> **Slug:** `SUPABASE_UPDATE_STORAGE_OBJECT`
>
> Update the object at an existing key. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Table Rows
>
> **Slug:** `SUPABASE_UPDATE_TABLE_ROWS`
>
> Update matching rows in an exposed Supabase table or updatable view. Uses a secret or service\_role project key, bypassing Row Level Security. PostgREST warns that unfiltered PATCH updates every row: filters are required unless allow\_all\_rows=true. Filters can still match every row; check them carefully. OAuth needs secrets:read; fine-grained PATs need api\_gateway\_keys\_read and api\_gateway\_keys\_secret\_read to reveal the project key.
>
> #### Input Parameters
>
> **count** `string ("exact" | "planned" | "estimated")`
>
> Optional PostgREST count strategy. Exact counts may be expensive.
>
> **table** `string` *required*
>
> Exposed table or updatable view name, without a schema prefix.
>
> **schema** `string`
>
> Exposed database schema for Content-Profile; omit for the server default.
>
> **select** `string`
>
> PostgREST columns/embedded resources to return with returning=representation.
>
> **columns** `string`
>
> Comma-separated payload column names to update; other payload keys are ignored. Omit to update the keys in updates. Listed keys absent from updates may be set to null.
>
> **filters** `object`
>
> PostgREST filters, e.g. \{'id': 'eq.42', 'age': 'lt.13'} or \{'or': '(id.eq.1,id.eq.2)'}. Multiple keys are ANDed. Embedded-resource filters alone do not constrain target rows. Broad filters may match every row.
>
> **updates** `object` *required*
>
> JSON object mapping column names to new values, applied to every matching row. Explicit null sets a column to SQL NULL; omitted keys are not updated unless included explicitly in columns.
>
> **returning** `string ("representation" | "minimal")`
>
> PostgREST return preference: representation returns updated rows; minimal returns no body. Omit to use the server default (minimal).
>
> **project\_ref** `string` *required*
>
> Unique 20-character reference ID of the Supabase project.
>
> **allow\_all\_rows** `boolean`
>
> Explicitly permit an update without target-row filters. Defaults to false to prevent accidental full-table updates, as warned by PostgREST. Set true only when intentionally updating every row.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Signed Object
>
> **Slug:** `SUPABASE_UPLOAD_SIGNED_OBJECT`
>
> Upload an object using a presigned URL.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **token** `string` *required*
>
> Documented query parameter token.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Storage Object
>
> **Slug:** `SUPABASE_UPLOAD_STORAGE_OBJECT`
>
> Upload a new object. Uses a secret/service-role project key and bypasses Row Level Security.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File or TUS chunk bytes to upload. Supply a Composio file handle.
>
> **x\_upsert** `boolean`
>
> Allow overwriting an existing object; defaults to the provider default (false).
>
> **bucket\_name** `string` *required*
>
> Documented path parameter bucketName.
>
> **object\_path** `string` *required*
>
> Documented path parameter \*.
>
> **project\_ref** `string` *required*
>
> Supabase project reference. Uses its project Storage API, not the Management API.
>
> **content\_type** `string`
>
> Object media type; TUS PATCH always uses application/offset+octet-stream.
>
> **cache\_control** `string`
>
> Cache-Control for the uploaded object.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert migration
>
> **Slug:** `SUPABASE_UPSERT_MIGRATION`
>
> Tool to upsert a database migration without applying it. Use when you need to track migration changes for a project. \[Beta] This endpoint stores migration metadata without executing the SQL.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> Project's unique reference identifier (20 lowercase letters).
>
> **name** `string`
>
> Optional name for the migration. Used for tracking and identification purposes.
>
> **query** `string` *required*
>
> The SQL migration query to be stored. This query will be tracked but not executed. Must be non-empty.
>
> **rollback** `string`
>
> Optional rollback SQL query to undo this migration if needed.
>
> **idempotency\_key** `string`
>
> A unique key to ensure the same migration is tracked only once. If provided, prevents duplicate migrations with the same key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reverify custom hostname
>
> **Slug:** `SUPABASE_VERIFY_CUSTOM_HOSTNAME_DNS`
>
> Re-verifies DNS and SSL configurations for an existing custom hostname associated with a Supabase project.
>
> #### Input Parameters
>
> **ref** `string` *required*
>
> The unique reference ID of the Supabase project for which the custom hostname is being re-verified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
