Skip to main content
Supabase logo
  • Category: developer tools
  • Auth: OAUTH2, API_KEY
  • Composio-managed OAuth available? Yes
  • Tools: 235
  • Triggers: 0
  • Slug: SUPABASE
  • Version: 20261103_00

Frequently Asked Questions

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

Slug: SUPABASE_ACCEPT_INVITE_EXTERNAL_JIT_ACCESSAccept an invitation for JIT database access.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_ALPHA_CREATE_API_KEYCreates a publishable or secret API key for an existing Supabase project, optionally with a description.

Input Parameters

string
required
The unique reference ID of the Supabase project.
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’.
string ("publishable" | "secret")
required
Specifies the type of API key: ‘publishable’ for client-side use or ‘secret’ for server-side operations.
string
Optional human-readable description for the API key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_ALPHA_DELETE_API_KEYPermanently deletes a specific API key (identified by id) from a Supabase project (identified by ref), revoking its access.

Input Parameters

string
required
The unique identifier of the API key that needs to be deleted from the project.
string
required
The unique reference ID of the Supabase project from which the API key is to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_ALPHA_DELETE_THIRD_PARTY_AUTH_INTEGRATIONRemoves 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

string
required
The unique reference ID of the Supabase project.
string
required
The unique identifier (ID) of the third-party authentication provider configuration to be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_ALPHA_GET_THIRD_PARTY_INTEGRATIONRetrieves 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

string
required
The unique identifier (reference) of the Supabase project.
string
required
The unique identifier of the specific third-party authentication provider configuration to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_ALPHA_LIST_THIRD_PARTY_AUTH_INTEGRATIONSLists 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

string
required
The unique identifier of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_ALPHA_UPDATE_API_KEYUpdates the description of an existing Supabase project API key without regenerating the key string.

Input Parameters

string
required
The unique identifier of the API key that needs to be updated.
string
required
The unique reference ID of the Supabase project to which the API key belongs.
string
Optional new description for the API key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_APPEND_RESUMABLE_UPLOADAppend 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

object
required
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.
integer
required
Expected byte offset returned by the upload HEAD response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_APPEND_RESUMABLE_UPLOAD_SIGNEDAppend data to a signed resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.

Input Parameters

object
required
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
required
Signed upload token from SUPABASE_CREATE_SIGNED_UPLOAD_URL; forwarded only to this project Storage endpoint.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.
integer
required
Expected byte offset returned by the upload HEAD response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_APPLY_A_MIGRATIONApplies 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

string
required
The unique reference ID of the Supabase project (e.g., ‘pamqaklsszmjzugtywow’). Found in Project Settings > General > Reference ID.
string
A unique name for the migration to track it in the migration history. If not provided, a default name will be assigned.
string
required
The SQL migration query to execute against the project’s database. Must be at least 1 character long.
string
Optional SQL query to rollback/undo this migration if needed.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_APPLY_PROJECT_ADDONApply or update billing addons and compute instance size. Changes may affect billing; inspect the project plan before modifying addons.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_AUTHORIZE_JIT_ACCESSAuthorize user-to-role mappings for JIT access.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_ACTIVATE_CUSTOM_HOSTNAMEActivates a previously configured custom hostname for a Supabase project, assuming DNS settings are verified externally.

Input Parameters

string
required
The unique identifier (project ID) of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_ACTIVATE_VANITY_SUBDOMAINActivates 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

string
required
Unique reference ID of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_AUTHORIZE_USER_THROUGH_OAUTHRequests 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

string
Space-separated list of OAuth scopes for requested permissions on user resources (e.g., ‘email profile’, ‘storage.objects.read’).
string
Opaque value to maintain state between request and callback; returned unmodified to aid CSRF prevention.
string
required
Unique identifier for the OAuth client application, registered with Supabase. Must be a valid client_id from a registered OAuth application.
string
required
URI where Supabase redirects the user after authorization; must exactly match a registered URI for the client application.
string
Specifies how authorization response parameters are returned (e.g., ‘query’, ‘fragment’, ‘form_post’). Default is determined by response_type if not specified.
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).
string
PKCE code challenge to secure authorization code grants, typically a BASE64URL-encoded SHA256 hash of code_verifier.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_CHECK_VANITY_SUBDOMAIN_AVAILABILITYChecks 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

string
required
The unique reference ID of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_CREATE_READ_REPLICAProvisions 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

string
required
Unique reference ID of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_ENABLE_DATABASE_WEBHOOKSEnables database webhooks for the Supabase project ref, triggering real-time notifications for INSERT, UPDATE, or DELETE events.

Input Parameters

string
required
The unique identifier for the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_GET_PROJECT_CUSTOM_HOSTNAME_CONFIGRetrieves 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

string
required
The unique reference ID of the Supabase project. This ID can typically be found in your project’s dashboard URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_GET_PROJECT_NETWORK_BANSRetrieves the list of banned IPv4 addresses for a Supabase project using its unique project reference string; this is a read-only operation.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_GET_PROJECT_NETWORK_RESTRICTIONSRetrieves 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_GET_PROJECT_PGSODIUM_CONFIGRetrieves the PGSodium configuration, including the root encryption key, for an existing Supabase project identified by its ref.

Input Parameters

string
required
The unique identifier of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_GET_PROJECT_SSL_ENFORCEMENT_CONFIGRetrieves the SSL enforcement configuration for a specified Supabase project, indicating if SSL connections are mandated for its database.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_GET_VANITY_SUBDOMAIN_CONFIGFetches 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

string
required
The unique reference ID of the Supabase project for which to fetch the vanity subdomain configuration.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_REMOVE_NETWORK_BANSRemoves specified IPv4 addresses from a Supabase project’s network ban list, granting immediate access; IPs not currently banned are ignored.

Input Parameters

string
required
The unique reference ID of the Supabase project.
array
required
A list of IPv4 addresses to be removed from the project’s network ban list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_REMOVE_READ_REPLICAInitiates 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

string
required
The unique project reference ID (20 lowercase characters, e.g. ‘abcdefghijklmnopqrst’). Found in project settings or URL.
string
required
The unique identifier of the read replica database to remove. Obtain from the project’s database settings or read replica listing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_RUN_SQL_QUERYExecutes 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

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>. Can also be provided as ‘project_ref’.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_UPDATE_PROJECT_NETWORK_RESTRICTIONSUpdates 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

string
required
Unique reference ID of the Supabase project.
array
List of IPv4 addresses or CIDR notations for database access; [] removes all IPv4 restrictions, null/omitted leaves current IPv4 restrictions unchanged.
array
List of IPv6 addresses or CIDR notations for database access; [] removes all IPv6 restrictions, null/omitted leaves current IPv6 restrictions unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_BETA_UPGRADE_PROJECT_POSTGRES_VERSIONInitiates 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

string
required
The project’s unique reference ID.
string
required
Target PostgreSQL version (e.g., ‘15.1.0.123’); must be available in the specified release_channel.
string ("alpha" | "beta" | "ga" | "internal" | "withdrawn")
required
Release channel for selecting the PostgreSQL version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CANCEL_PROJECT_RESTORATIONCancel project restoration.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_COPY_STORAGE_OBJECTCopy an object. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_COUNT_ACTION_RUNSCounts 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_COUNT_FUNCTION_RESULTSCount 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

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.
integer
Optional page size; does not limit the total matching-row count.
string
PostgREST result ordering, e.g. created_at.desc.
integer
Optional page offset; does not subtract from the total count.
string
Exposed schema sent as Accept-Profile; omit for the default schema.
string
PostgREST column/embedded-resource selection, e.g. id,name.
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.
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.
string
required
Unique 20-character reference ID of the Supabase project.
string
required
Name of the exposed, read-only table-valued Postgres function.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_COUNT_TABLE_ROWSCount 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

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.
integer
Page size, including zero. Does not cap the matching-row total.
string
PostgREST ordering expression, for example created_at.desc.
string
required
Name of an exposed table or view, without a schema prefix.
integer
Rows to skip for the requested page, not the matching-row total.
string
Exposed schema to select through Accept-Profile; omit for the default schema.
string
PostgREST column and embedded-resource selection, for example id,name.
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.
string
required
Unique 20-character reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_A_PROJECTCreates a new Supabase project, requiring a unique name (no dots) within the organization; project creation is asynchronous.

Input Parameters

string
required
Name for the new project; must be unique within the organization and not contain dots.
string ("free" | "pro")
Subscription plans (now set at the organization level).
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.
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.
boolean
Deprecated and ignored.
string
Optional URL to a Supabase project template (e.g., from Git) to initialize the project.
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.
string ("15")
Supported major versions of the PostgreSQL engine.
string ("alpha" | "beta" | "ga" | "internal" | "withdrawn")
Available release channels for Supabase software.
string ("12xlarge" | "16xlarge" | "2xlarge" | "4xlarge" | "8xlarge" | "large" | "medium" | "micro" | "small" | "xlarge")
Available compute instance sizes for a Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_BULK_SECRETSBulk 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

string
required
The unique reference ID (ref) of the Supabase project where secrets will be created.
array
required
List of secrets to create. Each secret must have a unique name that doesn’t start with SUPABASE_.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_DATABASE_BRANCHCreates 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

string
required
The unique reference ID of the parent Supabase project.
string
Geographical region for the new database branch.
string
Git branch name to associate with this database branch, linking database states to code branches.
boolean
Specifies if the branch is persistent (true) or ephemeral (false); ephemeral branches might be auto-deleted.
string
required
A unique name for the new database branch.
string ("15")
Desired PostgreSQL engine version for the new branch.
string ("alpha" | "beta" | "ga" | "internal" | "withdrawn")
Release channel for Supabase features on this branch, determining feature stability.
string ("12xlarge" | "16xlarge" | "2xlarge" | "4xlarge" | "8xlarge" | "large" | "medium" | "micro" | "small" | "xlarge")
Compute instance size for the new database branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_FUNCTIONCreates 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

string
required
Project’s unique identifier (path parameter).
string
required
JavaScript or TypeScript source code for the Edge Function.
string
required
Human-readable name for the function.
string
required
URL-friendly identifier for the function’s route prefix. Must be unique within the project.
boolean
If true, enable import map for ES module resolution.
boolean
If true, verify JWT in Authorization header before invoking the function. Set to false for public endpoints like webhooks.
string
Path to main function code, relative to project’s functions directory. Defaults to ./index.ts or ./index.js in function’s slug directory.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_LOGIN_ROLECreates a temporary CLI login role for database access with specified permissions; use when setting up CLI authentication for development or administrative tasks.

Input Parameters

string
required
Project reference ID (unique identifier for the Supabase project).
boolean
required
Whether the login role should have read-only permissions. Set to true for read-only access, false for full access.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_ORGANIZATIONCreates a new Supabase organization, which serves as a top-level container for projects, billing, and team access.

Input Parameters

string
required
The name for the new organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_PROJECT_SIGNING_KEYCreate a new JWT signing key for a Supabase project, with an optional initial standby or in-use status.

Input Parameters

string
required
The unique reference ID of the Supabase project. Can also be provided as ‘project_ref’.
string ("in_use" | "standby")
Status of a signing key in request.
string ("EdDSA" | "ES256" | "RS256" | "HS256")
required
The cryptographic algorithm to use for the signing key. HS256 is recommended for most use cases.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_RESUMABLE_UPLOADCreate 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
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.
integer
required
Total upload size in bytes, per the TUS creation extension.
string
required
TUS metadata: comma-separated key base64(value) pairs including bucketName, objectName, contentType and cacheControl.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_RESUMABLE_UPLOAD_SIGNEDCreate a signed TUS resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.

Input Parameters

object
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
required
Signed upload token from SUPABASE_CREATE_SIGNED_UPLOAD_URL; forwarded only to this project Storage endpoint.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.
integer
required
Total upload size in bytes, per the TUS creation extension.
string
required
TUS metadata: comma-separated key base64(value) pairs including bucketName, objectName, contentType and cacheControl.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_SIGNED_DOWNLOAD_URLGenerate a time-limited download capability for an object. Uses privileged project-key discovery; protect the returned URL.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_SIGNED_DOWNLOAD_URLSGenerate time-limited download capabilities for multiple objects. Uses privileged project-key discovery; protect the returned URLs.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Documented path parameter bucketName.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_SIGNED_UPLOAD_URLCreate 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

boolean
Allow the signed upload to overwrite an existing object at this path.
string
required
Existing Storage bucket that will receive the object.
string
required
Object path including its file name.
string
required
Unique 20-character reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_SSO_PROVIDERCreates 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

string
required
Unique reference ID of the Supabase project.
string ("saml")
required
Type of the SSO provider; ‘saml’ (SAML 2.0) is the only supported value.
array
Email domains to associate with this SSO provider; users from these domains will be directed here for authentication.
string
URL to fetch SAML 2.0 metadata XML. Provide this or metadata_xml.
string
SAML 2.0 metadata XML document as a string. Provide this or metadata_url.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_STORAGE_BUCKETCreate a Storage bucket. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_CREATE_THIRD_PARTY_AUTH_INTEGRATIONCall 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

string
required
The unique identifier of the Supabase project.
string
URL of the JSON Web Key Set (JWKS) for public key verification. Required if oidc_issuer_url is not provided.
string
URL of the OpenID Connect (OIDC) issuer. Required if jwks_url is not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_ALL_BRANCHESDisables 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_BUCKET_LIFECYCLEDelete bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_CUSTOM_HOSTNAME_CONFIGDeletes 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

string
required
The unique reference ID of the Supabase project for which the custom hostname configuration will be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_DATABASE_BRANCHPermanently and irreversibly deletes a specific, non-default database branch by its branch_id, without affecting other branches.

Input Parameters

string
required
The unique identifier of the database branch to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_EDGE_FUNCTIONDeletes 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

string
required
Project ref - unique identifier for the Supabase project.
string
required
Function slug - URL-friendly identifier of the Edge Function to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_FUNCTIONPermanently 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

string
required
The unique identifier of the Supabase project from which the function will be deleted.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_INVITE_EXTERNAL_JIT_ACCESSDelete an external user’s JIT invitation.

Input Parameters

string
required
Project ref
string
required
Documented path parameter invite_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_JIT_ACCESSDelete JIT access by user ID.

Input Parameters

string
required
Project ref
string
required
Documented path parameter user_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
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

string
required
The unique project reference identifier for the Supabase project from which CLI login roles will be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_PROJECTPermanently 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_PROJECT_VANITY_SUBDOMAINPermanently and irreversibly deletes an active vanity subdomain configuration for the specified Supabase project, reverting it to its default Supabase URL.

Input Parameters

string
required
The unique reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_SECRETSDeletes 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

string
required
The unique reference ID (ref) of the Supabase project whose secrets should be deleted.
array
required
List of secret names to delete. Each name must match an existing secret in the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_SSO_PROVIDERDeletes 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

string
required
The unique identifier for your Supabase project.
string
required
The unique identifier (UUID) of the SSO provider to be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_STORAGE_BUCKETDelete a bucket. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_STORAGE_OBJECTDelete a Storage object. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_STORAGE_OBJECTSDelete multiple objects. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Documented path parameter bucketName.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DELETE_TABLE_ROWSPermanently 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

string ("exact" | "planned" | "estimated")
Optional affected-row count strategy; exact can be slower.
string
required
Exposed table or updatable view name, without a schema prefix.
string
Exposed schema sent as Content-Profile; omit for the project’s default.
string
PostgREST columns/embedded resources to return with representation.
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.
string ("representation" | "minimal")
Return deleted rows (representation) or no body (minimal). Omit to use PostgREST’s default, minimal.
string
required
Unique 20-character reference ID of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DEPLOY_FUNCTIONDeploys Edge Functions to a Supabase project using multipart upload.

Input Parameters

string
required
Supabase project reference ID (e.g. qftqfrxipqlzcmjcatfc).
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.
string
Slug of the function to deploy.
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.
boolean
If true, only bundle the function without publishing it.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DISABLE_PREVIEW_BRANCHINGDisables 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

string
required
The unique reference ID of the Supabase project for which preview branching is to be disabled.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DISABLE_PROJECT_READONLYTemporarily 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

string
required
Unique reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DOWNLOAD_PRIVATE_OBJECTDownloads 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

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.
string
Optional object version ID to download instead of the current version.
string
required
Name of the private Storage bucket containing the object.
string
required
Full path and file name of the object inside the bucket.
string
required
Unique 20-character lowercase reference ID of the Supabase project.
string
Optional filename requested through Supabase’s download query parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DOWNLOAD_PUBLIC_OBJECTRetrieve an object from a public bucket.

Input Parameters

string
Documented query parameter download.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DOWNLOAD_SIGNED_OBJECTRetrieve an object using a presigned URL.

Input Parameters

string
required
Documented query parameter token.
string
Documented query parameter download.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_DOWNLOAD_STORAGE_OBJECTRetrieve a Storage object. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
Documented query parameter download.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_EMPTY_STORAGE_BUCKETEmpty a bucket. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
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

string
Authorization code from the server; required if grant_type is ‘authorization_code’.
string
required
Application’s client ID.
string ("authorization_code" | "refresh_token")
required
OAuth 2.0 grant type that dictates the token exchange flow.
string
Redirect URI from the initial authorization; required if grant_type is ‘authorization_code’ and it was part of the original request.
string
required
Application’s client secret.
string
PKCE code verifier; required if PKCE was used with an ‘authorization_code’ grant type.
string
Refresh token for acquiring a new access token; required if grant_type is ‘refresh_token’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GENERATE_TYPESCRIPT_TYPESGenerates and retrieves TypeScript types from a Supabase project’s database; any schemas specified in included_schemas must exist in the project.

Input Parameters

string
required
The unique reference ID of the Supabase project for which to generate TypeScript types.
string
Comma-separated database schema names to include in the generated TypeScript types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_ACTION_RUNRetrieves 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

string
required
The unique reference ID of the Supabase project. Must be exactly 20 lowercase alphanumeric characters.
string
required
The unique identifier of the action run to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_ACTION_RUN_LOGSRetrieves 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

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;).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_AUTH_CONFIGRetrieves 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

string
required
The unique reference ID of the Supabase project. Can also be provided as ‘project_ref’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_AUTHENTICATED_IMAGE_HEADERSGet authenticated image transformation headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
string
Documented query parameter download.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_AUTHENTICATED_OBJECT_HEADERSRetrieve authenticated object information headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_AUTHENTICATED_OBJECT_INFORetrieve authenticated object information. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_AUTHENTICATED_OBJECT_INFO_HEADERSGet authenticated object information headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_AVAILABLE_REGIONSTool 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

string ("NA" | "SA" | "EU" | "AF" | "AS" | "OC" | "AN")
Continent codes for regional recommendations.
string
required
Slug of your organization. This is required to retrieve available regions for project creation.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_BACKUP_SCHEDULEGet the project’s backup schedule.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_BRANCHRetrieves 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

string
required
The unique reference identifier (project ref) of the parent Supabase project. This ID can be found in your project’s dashboard URL.
string
required
The unique name of the database branch to retrieve (e.g., ‘test-branch-fix’, ‘staging’, ‘feature-x’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_BUCKET_LIFECYCLEGet bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_BUCKET_LIFECYCLE_HEADERSGet bucket lifecycle response headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_DATABASE_BRANCH_CONFIGRetrieves the read-only configuration and status for a Supabase database branch, typically for monitoring or verifying its settings.

Input Parameters

string
required
Project reference (ref) for the database branch. Must be exactly 20 lowercase alphabetic characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_DATABASE_DISKGet database disk attributes.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_DATABASE_METADATAGets 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

string
required
Project ref. The unique reference ID of the Supabase project (visible in your Supabase project URL).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_DATABASE_OPENAPIGet the project’s PostgREST OpenAPI specification.

Input Parameters

string
required
Project ref
string
The database schema to generate the OpenAPI spec for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_DISK_UTILIZATIONGet disk utilization.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_FUNCTIONRetrieves detailed information, metadata, configuration, and status for a specific Edge Function using its project reference ID and function slug.

Input Parameters

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>) or by using the ‘List all projects’ API.
string
required
The unique identifier (slug) for the Edge Function.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_FUNCTION_BODYRetrieves 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

string
required
The unique reference ID of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_HEALTHChecks the Supabase API for availability, helping diagnose connectivity issues.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_JIT_ACCESSGet user-to-role mappings for JIT database access.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_JIT_ACCESS_CONFIGRetrieves a Supabase project’s just-in-time (JIT) access configuration state using the beta endpoint.

Input Parameters

string
required
The unique reference ID of the Supabase project. Can also be provided as ‘project_ref’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_LEGACY_SIGNING_KEYDeprecated 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_MIGRATIONRetrieves 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

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>) or by using the ‘List all projects’ API.
string
required
The version identifier of the migration to fetch. Typically a timestamp-based identifier (e.g., ‘20260216042751’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_ORGANIZATIONFetches comprehensive details for a specific Supabase organization using its unique slug.

Input Parameters

string
required
The unique, URL-friendly identifier of the organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_ORGANIZATION_ENTITLEMENTSGet organization entitlements.

Input Parameters

string
required
Organization slug

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PERFORMANCE_ADVISORSRetrieves 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROFILEGet the user’s profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECTRetrieves 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

string
required
Project ref - unique identifier (20 lowercase letters) for the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_API_KEYRetrieves 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

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.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_API_KEYSRetrieves all API keys for an existing Supabase project, specified by its unique reference ID (ref); this is a read-only operation.

Input Parameters

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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_CONFIGRetrieve 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

string
required
Twenty-letter lowercase Supabase project reference.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_DISK_AUTOSCALE_CONFIGGet disk autoscale configuration.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_FUNCTION_COMBINED_STATSGet combined function statistics.

Input Parameters

string
required
Project ref
string ("15min" | "1hr" | "3hr" | "1day")
required
Documented query parameter interval.
string
required
Documented query parameter function_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_LEGACY_API_KEYSDeprecated 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_LOGSRetrieves 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

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.
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.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_METRICSRetrieve a Supabase project’s Prometheus/OpenMetrics exposition.

Input Parameters

string
required
The unique 20-character reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_PGBOUNCER_CONFIGRetrieves the active PgBouncer configuration (PostgreSQL connection pooler) for a Supabase project, used for performance tuning, auditing, or getting the connection string.

Input Parameters

string
required
The unique ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_POSTGRES_CONFIGRetrieves 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

string
required
The unique reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_POSTGREST_CONFIGRetrieves the PostgREST configuration for a specific Supabase project.

Input Parameters

string
required
The unique identifier of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_READONLY_MODE_STATUSRetrieves 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

string
required
Project reference ID, found in your project’s dashboard URL (e.g., https://supabase.com/dashboard/project/<project-ref>).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_SIGNING_KEYSTool 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_SUPAVISOR_CONFIGRetrieves the Supavisor (connection pooler) configuration for a specified Supabase project, identified by its reference ID.

Input Parameters

string
required
The unique reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_UPGRADE_ELIGIBILITYChecks a Supabase project’s eligibility for an upgrade, verifying compatibility and identifying potential issues; this action does not perform the actual upgrade.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_UPGRADE_STATUSRetrieves the latest status of a Supabase project’s database upgrade for monitoring purposes; does not initiate or modify upgrades.

Input Parameters

string
required
The unique reference ID of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_USAGE_API_COUNTGet project usage API counts.

Input Parameters

string
required
Project ref
string ("15min" | "30min" | "1hr" | "3hr" | "1day" | "3day" | "7day")
Documented query parameter interval.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PROJECT_USAGE_REQUEST_COUNTGet project usage API request counts.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PUBLIC_IMAGE_HEADERSGet public image transformation headers.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
string
Documented query parameter download.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PUBLIC_OBJECT_HEADERSGet public object information headers.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_PUBLIC_OBJECT_INFOGet public object information.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_REALTIME_CONFIGGet Realtime configuration.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_RESUMABLE_UPLOAD_BASE_OPTIONSHandles 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_RESUMABLE_UPLOAD_OPTIONSHandles 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_RESUMABLE_UPLOAD_STATUSGet 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

string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_RESUMABLE_UPLOAD_STATUS_SIGNEDGet signed resumable upload offset and metadata. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.

Input Parameters

string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
required
Signed upload token from SUPABASE_CREATE_SIGNED_UPLOAD_URL; forwarded only to this project Storage endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_SECURITY_ADVISORSRetrieves 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

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.
string ("sql")
Type of linting to perform for security advisors.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_SIGNED_IMAGE_HEADERSGet signed image transformation headers.

Input Parameters

string
required
Documented query parameter token.
string
Documented query parameter download.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_SIGNED_OBJECT_HEADERSGet headers for a presigned object retrieval.

Input Parameters

string
required
Documented query parameter token.
string
Documented query parameter download.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GETS_PROJECT_S_AUTH_CONFIGRetrieves a project’s authentication configuration, including provider, MFA, email, SMS, JWT and security settings. The response can contain sensitive secrets.

Input Parameters

string
required
The unique reference ID of the Supabase project. Can also be provided as ‘project_ref’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GETS_PROJECT_S_SERVICE_HEALTH_STATUSRetrieves the current health status for a Supabase project, for specified services or all services if the ‘services’ list is omitted.

Input Parameters

string
required
The unique identifier (ref) of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_SQL_SNIPPETRetrieves a specific SQL snippet by its unique identifier.

Input Parameters

string
required
The unique identifier of the SQL snippet to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_SSO_PROVIDERRetrieves configuration details for a project’s SAML Single Sign-On provider by UUID.

Input Parameters

string
required
The unique reference ID of the Supabase project.
string
required
The unique identifier (UUID) of the SSO provider whose configuration is to be fetched.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_BUCKETGet bucket details. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_BUCKET_HEADERSGet bucket response headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_BUCKET_LIST_HEADERSGet bucket-list response headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter limit.
integer
Documented query parameter offset.
Documented query parameter search.
string ("asc" | "desc")
Documented query parameter sortOrder.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string ("id" | "name" | "created_at" | "updated_at")
Documented query parameter sortColumn.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_CONFIGGet project Storage configuration.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_HEALTHCheck the Storage service health, distinct from Management API health.

Input Parameters

string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_HEALTH_HEADERSGet Storage service health response headers.

Input Parameters

string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_OBJECT_HEADERSRetrieve object information headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_OBJECT_INFORetrieve object information. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_STORAGE_OBJECT_INFO_HEADERSGet object information headers. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_GET_TABLE_SCHEMASRetrieve 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

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;).
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.
boolean
Whether to include index information in the response
boolean
Whether to exclude properties with null values from the response for cleaner output
boolean
Whether to include foreign key relationships in the response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONSSend an OPTIONS request to the TUS resumable upload signing endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONS_WITH_IDSend an OPTIONS request to a TUS resumable upload signing endpoint for a specified path.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_INSERT_TABLE_ROWSInsert 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

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.
string ("exact" | "planned" | "estimated")
Optional affected-row count strategy; exact can be slower.
string
required
Exposed table or writable view name, without a schema prefix.
string
Exposed database schema. Omit to use the project’s default schema.
string
PostgREST projection or embedded resources for return=representation.
string
PostgREST comma-separated payload columns to insert; other keys are ignored.
string
Use database defaults for missing payload columns instead of null.
string ("merge-duplicates" | "ignore-duplicates")
Enable upsert by merging conflicting rows or ignoring duplicates.
string
Comma-separated UNIQUE columns to use for upsert conflict detection.
string
required
Unique 20-character lowercase reference ID of the Supabase project.
string ("representation" | "minimal")
Return affected rows or no body. Omit for the provider default (minimal).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_INVITE_EXTERNAL_JIT_ACCESSInvite an external user for JIT database access.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_INVOKE_DATABASE_FUNCTIONInvoke 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

string ("exact" | "planned" | "estimated")
Optional PostgREST count strategy for a table-valued function. Exact counts may be slower on large results.
integer
Maximum rows to return from a table-valued function; use 0 to return no rows while requesting a count.
string
PostgREST ordering expression for a table-valued result.
integer
Rows to skip before returning a table-valued function page.
string
Exposed database schema containing the function. Omit to use the project’s default exposed schema, usually public.
string
Columns and embedded resources to return from a table-valued function, using PostgREST select syntax.
object
Filters for a table-valued function, mapping each column or embedded field to a PostgREST expression such as {‘rating’: ‘gt.8’}.
object
Named function arguments as a JSON object; omit for a function without arguments.
string
required
Unique 20-character reference ID of the Supabase project.
string
required
Name of the exposed Postgres function to invoke.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_INVOKE_EDGE_FUNCTIONTool 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

string
Request body to send to the function. Can be a JSON object (dict) or a raw string.
string ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")
HTTP method to use when invoking the function.
object
Optional additional headers to send with the request (e.g., Content-Type).
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.
string
required
Unique reference ID of the Supabase project (used in the hostname).
string
required
Name/slug of the Edge Function to invoke.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_INVOKE_READ_ONLY_FUNCTIONInvoke 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

string ("exact" | "planned" | "estimated")
Optional row count strategy. Exact counts can be slow on large results.
integer
Maximum rows; 0 requests no rows, useful with count.
string
PostgREST ordering expression, e.g. created_at.desc.
integer
Number of table-valued result rows to skip.
string
Exposed schema for Accept-Profile; omit for the project default.
string
PostgREST column projection and embedding for a table-valued result.
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.
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.
string
required
Unique 20-character lowercase Supabase project reference.
string
required
Name of the exposed Postgres function, without a schema prefix.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_ACTION_RUNSList one page of action runs for a project.

Input Parameters

string
required
Project ref
number
Documented query parameter limit.
number
Documented query parameter offset.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_ALL_ORGANIZATIONSLists organizations associated with the authenticated Supabase account, returning their IDs, slugs, and names.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_ALL_PROJECTSLists 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_BACKUPSLists 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

string
required
The unique identifier (reference string) of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_BRANCHESLists 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

string
required
The unique reference identifier (project ref) of the Supabase project. This ID can be found in your project’s dashboard URL.
integer
Maximum number of branches to return per request. Defaults to 25.
integer
Number of branches to skip before returning results. Use for pagination.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_BUCKETSRetrieves a list of all storage buckets for a Supabase project, without returning bucket contents or access policies.

Input Parameters

string
required
The unique identifier of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_DATABASE_BRANCHESLists 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_FUNCTIONSLists metadata for all Edge Functions in a Supabase project (specified by ‘ref’), excluding function code or logs; the project must exist.

Input Parameters

string
required
The unique identifier of the Supabase project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_JIT_ACCESSList all user-to-role mappings for JIT access.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_MIGRATION_HISTORYRetrieves 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_ORGANIZATION_MEMBERSRetrieves all members of a Supabase organization, identified by its unique slug, including their user ID, username, email, role, and MFA status.

Input Parameters

string
required
The unique identifier (slug) of the organization for which to list members.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_ORGANIZATION_PROJECTSList one page of projects for an organization.

Input Parameters

string
required
Organization slug
string ("name_asc" | "name_desc" | "created_asc" | "created_desc")
Sort order for projects
integer
Number of projects to return per page
integer
Number of projects to skip
string
Search projects by name
string
A comma-separated list of project statuses to filter by. The following values are supported: ACTIVE_HEALTHY, INACTIVE.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_PROJECT_ADDONSList billing addons and compute instance selections. Changes may affect billing; inspect the project plan before modifying addons.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_PROJECT_RESTORE_VERSIONSList available restore versions for a project.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_PROJECT_SECRETSRetrieves 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_SECRETSRetrieves all secrets for a Supabase project using its reference ID; secret values in the response may be masked.

Input Parameters

string
required
The unique reference ID (ref) of the Supabase project whose secrets are to be retrieved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_SQL_SNIPPETSRetrieves 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_SSO_PROVIDERSLists all configured Single Sign-On (SSO) providers for a Supabase project, requiring the project reference ID (ref) of an existing project.

Input Parameters

string
required
The project’s reference ID. Typically found in dashboard settings or the API URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_STORAGE_BUCKETSList Storage buckets through the data-plane API. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter limit.
integer
Documented query parameter offset.
string
Documented query parameter search.
string ("asc" | "desc")
Documented query parameter sortOrder.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string ("id" | "name" | "created_at" | "updated_at")
Documented query parameter sortColumn.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_STORAGE_OBJECTSSearch for objects under a prefix. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Documented path parameter bucketName.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_STORAGE_OBJECTS_V2Search for objects under a prefix using list v2. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Documented path parameter bucketName.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_LIST_TABLESLists 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

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.
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;).
boolean
Whether to include views along with tables in the results
boolean
Whether to include basic metadata like estimated row count and table size
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_MERGE_BRANCHInitiates 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

string
required
The unique identifier (UUID format) or reference of the database branch to merge.
string
Optional migration version to merge up to. Format: timestamp like ‘20260216000000’. If not provided, merges all migrations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_MODIFY_DATABASE_DISKModify database disk configuration.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_MOVE_STORAGE_OBJECTMove an object. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_OAUTH_AUTHORIZE_PROJECT_CLAIMInitiate 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

string
Documented query parameter state.
string
required
Documented query parameter client_id.
string
required
Project ref
string
required
Documented query parameter redirect_uri.
string
Documented query parameter response_mode.
string ("code" | "token" | "id_token token")
required
Documented query parameter response_type.
string
Documented query parameter code_challenge.
string ("plain" | "sha256" | "S256")
Documented query parameter code_challenge_method.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
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

string
required
The unique reference ID of the Supabase project (used in the URL path). Must be exactly 20 lowercase letters (a-z).
string
New name for the migration entry. Updates the display name in migration history.
string
required
The version identifier of the migration to patch (typically a timestamp like ‘20260216042751’). This is found in the migration history.
string
SQL rollback script for the migration. Defines how to revert the migration changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_PATCH_NETWORK_RESTRICTIONSUpdates 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

object
Modification request for adding or removing network restriction CIDRs.
string
required
Unique reference ID of the Supabase project (visible in project URL).
object
Modification request for adding or removing network restriction CIDRs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_PAUSE_PROJECTPause a project, making its services unavailable until it is restored.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_POST_RESUMABLE_UPLOADCreate 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

object
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.
integer
required
Total upload size in bytes, per the TUS creation extension.
string
required
Comma-separated TUS key base64(value) pairs including bucketName, objectName and contentType.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_POST_RESUMABLE_UPLOAD_SIGNEDCreate 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

object
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
required
Signed upload token from SUPABASE_CREATE_SIGNED_UPLOAD_URL; forwarded only to this project Storage endpoint.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.
integer
required
Total upload size in bytes, per the TUS creation extension.
string
required
Comma-separated TUS key base64(value) pairs including bucketName, objectName and contentType.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_PURGE_BUCKET_CACHEPurge cache for a bucket or its transformations. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketName.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
boolean
Documented query parameter transformations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_PURGE_OBJECT_CACHEPurge cache for an object or its transformations. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
boolean
Documented query parameter transformations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_PURGE_STORAGE_CACHEPurge cache for the tenant or tenant transformations. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

string
required
Supabase project reference. Uses its project Storage API, not the Management API.
boolean
Documented query parameter transformations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_PUSH_BRANCHPushes 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

string
required
The unique identifier or reference of the database branch to push.
string
Optional migration version to push to the branch. Format: timestamp like ‘20260216000000’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_REMOVE_PROJECT_ADDONRemove billing addons or revert compute sizing. Changes may affect billing; inspect the project plan before modifying addons.

Input Parameters

string
required
Project ref
string
required
Documented path parameter addon_variant.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RENDER_AUTHENTICATED_IMAGERender an authenticated image with transformations. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
string
Documented query parameter download.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RENDER_PUBLIC_IMAGERender a public image with transformations.

Input Parameters

integer
Documented query parameter width.
string ("origin" | "avif" | "webp")
Documented query parameter format.
integer
Documented query parameter height.
string ("cover" | "contain" | "fill")
Documented query parameter resize.
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.
integer
Documented query parameter quality.
string
Documented query parameter download.
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.
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.
string
Documented query parameter versionId.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RENDER_SIGNED_IMAGERender a signed image with transformations.

Input Parameters

string
required
Documented query parameter token.
string
Documented query parameter download.
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_REPLACE_BUCKET_LIFECYCLEReplace bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RESET_DATABASE_BRANCHResets 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

string
required
The unique identifier of the database branch to reset.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RESTART_PROJECTRestart a project, temporarily interrupting its services. Newly provisioned projects must wait ten minutes.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RESTORE_BRANCHRestore a scheduled branch deletion.

Input Parameters

string
required
Branch ref or deprecated branch ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RESTORE_PITR_BACKUPRestores 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

string
required
Unique identifier of the Supabase project.
integer
required
Unix timestamp (seconds) for the desired database restoration point.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RESTORE_PROJECTRestore the given project.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_ROLLBACK_MIGRATIONSRollback database migrations and remove them from history.

Input Parameters

string
required
Rollback migrations greater or equal to this version
string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_RUN_READ_ONLY_QUERYRun 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

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>. Can also be provided as ‘project_ref’.
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”.
array
Optional array of parameters for parameterized queries. Use $1, $2, etc. in the query to reference parameters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_SELECT_FROM_TABLESelect 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

integer
Maximum number of rows to return (must be >= 1)
string
Ordering expression in the form column.asc or column.desc
string
required
Table or view name to select from
integer
Number of rows to skip before returning results (must be >= 0)
string
required
Comma-separated list of columns to return. Supports nested/related selections and JSON path selectors (e.g., address->postcode).
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).
string
required
Unique reference ID of the Supabase project (used in the hostname)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_SHUTDOWN_REALTIMEShut down the project Realtime service connections, disconnecting active clients.

Input Parameters

string
required
Project ref

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_TERMINATE_RESUMABLE_UPLOADTerminate 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

string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_TERMINATE_RESUMABLE_UPLOAD_SIGNEDTerminate a signed resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation.

Input Parameters

string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
required
Signed upload token from SUPABASE_CREATE_SIGNED_UPLOAD_URL; forwarded only to this project Storage endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_ACTION_RUN_STATUSUpdate the status of an action run.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Action Run ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_A_FUNCTIONUpdates 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

string
required
The unique reference ID of the Supabase project.
string
New source code (e.g., Deno/TypeScript) or base64-encoded ESZIP content for the function, sent in the request body.
string
Optional new name for the function. This value is sent in the request body as ‘name’.
string
Optional new slug for the function. If provided as a query parameter, this changes the function’s access URL.
boolean
Whether to use an import map for the function (query parameter).
boolean
Specifies whether JWT verification should be enabled. This value is sent in the request body as ‘verify_jwt’.
string
required
The current slug (unique identifier) of the Edge Function to be updated.
string
Path to the main Deno script for the function (query parameter).
string
Path to the import map file (query parameter).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_API_KEYUpdates 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

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.
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.
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’).
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.
string
Optional new description for the API key to help identify its purpose or usage context.
object
Template for claims/config associated with JWT-style keys.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_BACKUP_SCHEDULEUpdate the project’s backup schedule.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_BRANCHUpdates 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

string ("CREATING_PROJECT" | "RUNNING_MIGRATIONS" | "MIGRATIONS_PASSED" | "MIGRATIONS_FAILED" | "FUNCTIONS_DEPLOYED" | "FUNCTIONS_FAILED")
Status values that can be set when updating a branch.
string
Name of the Git branch to associate with this database branch. If not provided, the association remains unchanged.
string
HTTP endpoint to receive branch status updates. Must be a valid URI.
boolean
If true, the database branch is persistent; non-persistent branches may be auto-cleaned. If not provided, this setting remains unchanged.
string
New name for the database branch. If not provided, the name remains unchanged.
boolean
This field is deprecated and will be ignored. Use v1-reset-a-branch endpoint directly instead.
boolean
If true, requests a review for this branch. If not provided, this setting remains unchanged.
string
required
Unique identifier or reference of the database branch to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_DATABASE_BRANCH_CONFIGUpdates 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

string ("CREATING_PROJECT" | "FUNCTIONS_DEPLOYED" | "FUNCTIONS_FAILED" | "MIGRATIONS_FAILED" | "MIGRATIONS_PASSED" | "RUNNING_MIGRATIONS")
Status values that can be set when updating a branch.
string
required
Unique identifier of the database branch to update. Must be exactly 20 lowercase alphabetic characters.
string
Name of the Git branch to associate with this database branch. If not provided, the association remains unchanged.
boolean
If true, the database branch is persistent; non-persistent branches may be auto-cleaned. If not provided, this setting remains unchanged.
string
New name for the database branch. If not provided, the name remains unchanged.
boolean
If true, resets the database branch on new push to the linked Git branch. If not provided, this setting remains unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_DATABASE_PASSWORDUpdates the database password for a Supabase project. Use it to rotate credentials or recover database access.

Input Parameters

string
required
The unique reference ID of the Supabase project.
string
required
The new database password to set. Must be at least 4 characters long.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_FUNCTIONSBulk 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

string
required
Supabase project reference ID.
array
required
List of functions to update. Each function must have id, slug, name, status, and version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_JIT_ACCESSUpdate a user mapping for JIT access.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
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

string
required
Unique reference ID of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PGSODIUM_CONFIGUpdates a Supabase project’s pgsodium root encryption key. Changing the root key can make data encrypted with the previous key inaccessible.

Input Parameters

string
required
The unique identifier (ref ID) of the Supabase project.
string
required
The new root encryption key for pgsodium. Must be a cryptographically strong key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PROJECTUpdates a Supabase project’s configuration (currently supports updating the project name). Use when you need to rename an existing project.

Input Parameters

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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PROJECT_AUTH_CONFIGUpdate 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

string
required
The unique reference ID of the Supabase project. Can also be provided as ‘project_ref’.
integer
JWT access token expiration time in seconds.
string
Primary site URL used in email links and redirects. Critical for Auth redirect flows.
string
SMTP server host for sending auth emails.
string
SMTP password for authentication.
integer
SMTP server port.
string
SMTP username for authentication.
boolean
Disable new signups via email/password and OAuth providers.
integer
Email OTP expiration time in seconds.
string
Comma-separated allowlist of redirect URIs/patterns for OAuth callbacks.
integer
Maximum session lifetime in seconds. 0 means disabled.
string
Admin email address used as the sender for SMTP notifications.
string
Display name for the SMTP sender.
integer
Email OTP length (number of digits).
integer
Rate limit for verification attempts (generic).
string
Azure OAuth issuer or discovery URL.
boolean
Automatically confirm new signups (no email confirmation required).
integer
Rate limit for SMTP sends (emails per minute).
integer
Minimum required password length.
integer
Rate limit for sending SMS (messages per minute).
string
Apple OAuth client secret.
string
Azure OAuth client secret.
boolean
Enable HaveIBeenPwned check during password set/change.
integer
Rate limit for sending emails (emails per minute).
boolean
Enable Apple as an external OAuth provider.
boolean
Enable Azure as an external OAuth provider.
boolean
Enable email sign-in/up.
string
GitHub OAuth client secret.
string
Google OAuth client secret.
boolean
Enable phone (SMS) sign-in/up.
boolean
Enable GitHub as an external OAuth provider.
boolean
Enable Google as an external OAuth provider.
boolean
Enable enrolling TOTP as an MFA factor.
boolean
Enable TOTP verification as MFA.
string
CAPTCHA provider secret key.
string
Apple OAuth client ID.
string
Azure OAuth client ID.
integer
Maximum number of MFA factors a user can enroll.
boolean
Enable CAPTCHA verification for risky flows.
boolean
Restrict to a single active session per user.
string
GitHub OAuth client ID.
string
Google OAuth client ID.
string
CAPTCHA provider (e.g., hcaptcha, turnstile).
integer
Rate limit for anonymous users (requests per minute).
integer
Session inactivity timeout in seconds. 0 means disabled.
string
Character class requirements for passwords (e.g., regex or flags).
boolean
Enable refresh token rotation to reduce token replay risk.
boolean
Enable manual linking of identities to accounts.
boolean
Enable creation of anonymous users (no credentials).
boolean
Require secure email change flow (confirm both old and new emails).
integer
Allowed reuse interval (seconds) for rotated refresh tokens.
boolean
Allow sign-ins from users with unverified emails.
boolean
Enable notification emails when a user’s email is changed.
boolean
Enable notification emails when a phone number is changed.
boolean
Enable notification emails when an identity is linked.
boolean
Enable notification emails when a password is changed.
boolean
Enable notification emails when an identity is unlinked.
boolean
Enable notification emails when an MFA factor is enrolled.
boolean
Require reauthentication before updating password.
boolean
Enable notification emails when an MFA factor is unenrolled.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PROJECT_CUSTOM_HOSTNAMEUpdates 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

string
required
The unique identifier of the Supabase project.
string
required
Desired custom hostname (e.g., ‘api.example.com’) to associate with the project’s services.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PROJECT_LEGACY_API_KEYSDeprecated 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

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.
boolean
required
Enable or disable JWT-based legacy API keys (anon, service_role). Set to true to enable, false to disable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PROJECT_POSTGRES_CONFIGUpdates 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

string
required
The unique reference ID of the Supabase project.
string
Memory for internal sorts and hash tables before writing to temp disk files (e.g., ‘4MB’, ‘64MB’).
string
WAL size that triggers a checkpoint (e.g., ‘1GB’, ‘2048MB’).
string
Minimum size of past WAL log segments in pg_wal for standby servers (e.g., ‘128MB’, ‘512MB’); replaces older wal_keep_segments.
string
Memory for shared memory buffers (e.g., ‘128MB’, ‘1GB’).
integer
Maximum concurrent database connections. Typically between 1 and 262143.
string
Maximum allowed duration for any SQL statement (e.g., ‘10000ms’, ’30s’); ‘0’ typically disables timeout.
string
Estimated disk cache size for a single query (e.g., ‘4GB’, ‘512MB’).
string
Maximum memory for maintenance operations like VACUUM, CREATE INDEX (e.g., ‘64MB’, ‘1GB’).
integer
Maximum workers the system can support for parallel queries. Typically between 0 and 1024.
integer
Maximum background processes the system can support. Typically between 0 and 262143.
string
Maximum WAL file size replication slots can retain in pg_wal (e.g., ‘1GB’, ‘512MB’). ‘0’ might mean unlimited; check PostgreSQL docs.
string ("local" | "origin" | "replica")
Controls firing of replication-related triggers and rules for the current session.
integer
Controls the average number of object locks allocated per transaction. Typically between 10 and 2147483640.
string
Maximum delay before canceling queries on a hot standby server processing archived WAL data (e.g., ’30s’, ‘0ms’ to disable).
string
Maximum delay before canceling queries on a hot standby server processing streamed WAL data (e.g., ’30s’, ‘0ms’ to disable).
integer
Maximum workers for a single Gather or Gather Merge node in a parallel query. Typically between 0 and 1024.
integer
Maximum parallel processes for a single maintenance utility command. Typically between 0 and 1024.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PROJECT_POSTGREST_CONFIGUpdates 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

string
required
The unique identifier (reference) of the Supabase project.
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.
integer
The maximum number of rows PostgREST can return in a single response; this setting helps control payload size and query performance.
string
A comma-separated string of PostgreSQL schemas to be exposed through the PostgREST API (e.g., ‘public,api’).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_PROJECT_SUPAVISOR_CONFIGUpdates Supavisor (database pooler) configuration, including default pool size and pool mode, for an existing Supabase project identified by its reference.

Input Parameters

string
required
The unique identifier of the Supabase project.
string ("session" | "transaction")
This field is deprecated and is ignored in this request. It previously controlled the pooling mode (session or transaction).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_REALTIME_CONFIGUpdate Realtime configuration.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_SSL_ENFORCEMENT_CONFIGUpdates the SSL enforcement configuration (enable/disable) for a specified Supabase project’s database.

Input Parameters

string
required
The unique identifier of the Supabase project.
boolean
Desired SSL enforcement state for the project’s database (true to enable, false to disable).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_SSO_PROVIDERUpdates 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

string
required
Unique reference ID of the Supabase project.
array
Email domains to associate with this SSO provider for user authentication.
string
required
UUID of the SSO provider to update.
string
URL pointing to the SAML metadata XML. Use either this or metadata_xml.
string
SAML metadata XML content from the identity provider. Use either this or metadata_url.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_STORAGE_BUCKETUpdate bucket properties. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.
string
required
Documented path parameter bucketId.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_STORAGE_CONFIGUpdate project Storage configuration.

Input Parameters

string
required
Project ref
object
required
JSON body for this operation. Only explicitly supplied optional fields are sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_STORAGE_OBJECTUpdate the object at an existing key. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPDATE_TABLE_ROWSUpdate 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

string ("exact" | "planned" | "estimated")
Optional PostgREST count strategy. Exact counts may be expensive.
string
required
Exposed table or updatable view name, without a schema prefix.
string
Exposed database schema for Content-Profile; omit for the server default.
string
PostgREST columns/embedded resources to return with returning=representation.
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.
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.
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.
string ("representation" | "minimal")
PostgREST return preference: representation returns updated rows; minimal returns no body. Omit to use the server default (minimal).
string
required
Unique 20-character reference ID of the Supabase project.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPLOAD_SIGNED_OBJECTUpload an object using a presigned URL.

Input Parameters

object
required
File or TUS chunk bytes to upload. Supply a Composio file handle.
string
required
Documented query parameter token.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPLOAD_STORAGE_OBJECTUpload a new object. Uses a secret/service-role project key and bypasses Row Level Security.

Input Parameters

object
required
File or TUS chunk bytes to upload. Supply a Composio file handle.
boolean
Allow overwriting an existing object; defaults to the provider default (false).
string
required
Documented path parameter bucketName.
string
required
Documented path parameter *.
string
required
Supabase project reference. Uses its project Storage API, not the Management API.
string
Object media type; TUS PATCH always uses application/offset+octet-stream.
string
Cache-Control for the uploaded object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_UPSERT_MIGRATIONTool 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

string
required
Project’s unique reference identifier (20 lowercase letters).
string
Optional name for the migration. Used for tracking and identification purposes.
string
required
The SQL migration query to be stored. This query will be tracked but not executed. Must be non-empty.
string
Optional rollback SQL query to undo this migration if needed.
string
A unique key to ensure the same migration is tracked only once. If provided, prevents duplicate migrations with the same key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SUPABASE_VERIFY_CUSTOM_HOSTNAME_DNSRe-verifies DNS and SSL configurations for an existing custom hostname associated with a Supabase project.

Input Parameters

string
required
The unique reference ID of the Supabase project for which the custom hostname is being re-verified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not