AptlyStar

Supabase

Use Supabase database

Supabase is a powerful backend-as-a-service platform that provides developers with a suite of tools to build, scale, and manage modern applications. Supabase offers a fully managed PostgreSQL database, robust authentication, instant RESTful and GraphQL APIs, real-time subscriptions, file storage, and edge functions—all accessible through a unified and developer-friendly interface. Broad compatibility with popular frameworks makes it a compelling alternative to Firebase, with the added benefit of SQL flexibility and transparency.

Why Supabase?

  • Instant APIs: Every table and view in your database is instantly available via REST and GraphQL endpoints, making it easy to build data-driven applications without writing custom backend code.
  • Real-time Data: Supabase enables real-time subscriptions, allowing your apps to react instantly to changes in your database.
  • Authentication & Authorization: Built-in user management with support for email, OAuth, SSO, and more, plus row-level security for granular access control.
  • Storage: Securely upload, serve, and manage files with built-in storage that integrates seamlessly with your database.
  • Edge Functions: Deploy serverless functions close to your users for low-latency custom logic.

Using Supabase in Aptlystar

Aptlystar’s Supabase integration makes it effortless to connect your agentic workflows to your Supabase projects. With just a few configuration fields—your Project ID, Table name, and Service Role Secret—you can securely interact with your database directly from your Aptlystar blocks. The integration abstracts away the complexity of API calls, letting you focus on building logic and automations.

Key benefits of using Supabase in Aptlystar:

  • No-code/low-code database operations: Query, insert, update, and delete rows in your Supabase tables without writing SQL or backend code.
  • Flexible querying: Use PostgREST filter syntax to perform advanced queries, including filtering, ordering, and limiting results.
  • Seamless integration: Easily connect Supabase to other tools and services in your workflow, enabling powerful automations such as syncing data, triggering notifications, or enriching records.
  • Secure and scalable: All operations use your Supabase Service Role Secret, ensuring secure access to your data with the scalability of a managed cloud platform.

Whether you’re building internal tools, automating business processes, or powering production applications, Supabase in Aptlystar provides a fast, reliable, and developer-friendly way to manage your data and backend logic—no infrastructure management required. Simply configure your block, select the operation you need, and let Aptlystar handle the rest.

Usage Instructions

Integrate Supabase into the workflow. Supports database operations (query, insert, update, delete, upsert), full-text search, RPC functions, Edge Function invocation, row counting, vector search, and complete storage management (upload, download, list, move, copy, delete files and buckets).

Tools

supabase_query

Query data from a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to query
schemastringNoDatabase schema to query from (default: public). Use this to access tables in other schemas.
selectstringNoColumns to return (comma-separated). Defaults to * (all columns)
filterstringNoPostgREST filter (e.g., "id=eq.123")
orderBystringNoColumn to order by (add DESC for descending)
limitnumberNoMaximum number of rows to return
offsetnumberNoNumber of rows to skip (for pagination)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records returned from the query

supabase_insert

Insert data into a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to insert data into
schemastringNoDatabase schema to insert into (default: public). Use this to access tables in other schemas.
dataarrayYesThe data to insert (array of objects or a single object)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of inserted records

supabase_get_row

Get a single row from a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to query
schemastringNoDatabase schema to query from (default: public). Use this to access tables in other schemas.
selectstringNoColumns to return (comma-separated). Defaults to * (all columns)
filterstringYesPostgREST filter to find the specific row (e.g., "id=eq.123")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray containing the row data if found, empty array if not found

supabase_update

Update rows in a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to update
schemastringNoDatabase schema to update in (default: public). Use this to access tables in other schemas.
filterstringYesPostgREST filter to identify rows to update (e.g., "id=eq.123")
dataobjectYesData to update in the matching rows
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of updated records

supabase_delete

Delete rows from a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to delete from
schemastringNoDatabase schema to delete from (default: public). Use this to access tables in other schemas.
filterstringYesPostgREST filter to identify rows to delete (e.g., "id=eq.123")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of deleted records

supabase_upsert

Insert or update data in a Supabase table (upsert operation)

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to upsert data into
schemastringNoDatabase schema to upsert into (default: public). Use this to access tables in other schemas.
dataarrayYesThe data to upsert (insert or update) - array of objects or a single object
onConflictstringNoComma-separated column(s) with a unique or primary key constraint to resolve conflicts on (e.g., "email"). Defaults to the primary key.
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of upserted records

supabase_count

Count rows in a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to count rows from
schemastringNoDatabase schema to count from (default: public). Use this to access tables in other schemas.
filterstringNoPostgREST filter (e.g., "status=eq.active")
countTypestringNoCount type: exact, planned, or estimated (default: exact)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
countnumberNumber of rows matching the filter

Perform full-text search on a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to search
schemastringNoDatabase schema to search in (default: public). Use this to access tables in other schemas.
columnstringYesThe column to search in
querystringYesThe search query
searchTypestringNoSearch type: plain, phrase, or websearch (default: websearch)
languagestringNoLanguage for text search configuration (default: english)
limitnumberNoMaximum number of rows to return
offsetnumberNoNumber of rows to skip (for pagination)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records matching the search query

Perform similarity search using pgvector in a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
functionNamestringYesThe name of the PostgreSQL function that performs vector search (e.g., match_documents)
queryEmbeddingarrayYesThe query vector/embedding to search for similar items
matchThresholdnumberNoMinimum similarity threshold (0-1), typically 0.7-0.9
matchCountnumberNoMaximum number of results to return (default: 10)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records with similarity scores from the vector search. Each record includes a similarity field (0-1) indicating how similar it is to the query vector.

supabase_rpc

Call a PostgreSQL function in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
functionNamestringYesThe name of the PostgreSQL function to call
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsjsonResult returned from the function

supabase_invoke_function

Invoke a Supabase Edge Function over HTTP

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
functionNamestringYesThe name of the Edge Function to invoke (e.g., "hello-world")
methodstringNoHTTP method to use: GET, POST, PUT, PATCH, or DELETE (default: POST)
bodyjsonNoRequest payload to send to the function as a JSON object (ignored for GET)
headersjsonNoAdditional request headers as a JSON object of header name to value
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsjsonResponse body returned by the Edge Function

supabase_introspect

Introspect Supabase database schema to get table structures, columns, and relationships

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
schemastringNoDatabase schema to introspect (defaults to all user schemas, commonly "public")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
tablesarrayArray of table schemas with columns, keys, and indexes
↳ namestringTable name
↳ schemastringDatabase schema name
↳ columnsarrayArray of column definitions
↳ namestringColumn name
↳ typestringColumn data type
↳ nullablebooleanWhether the column allows null values
↳ defaultstringDefault value for the column
↳ isPrimaryKeybooleanWhether the column is a primary key
↳ isForeignKeybooleanWhether the column is a foreign key
↳ referencesobjectForeign key reference details
↳ tablestringReferenced table name
↳ columnstringReferenced column name
↳ primaryKeyarrayArray of primary key column names
↳ foreignKeysarrayArray of foreign key relationships
↳ columnstringLocal column name
↳ referencesTablestringReferenced table name
↳ referencesColumnstringReferenced column name
↳ indexesarrayArray of index definitions
↳ namestringIndex name
↳ columnsarrayColumns included in the index
↳ uniquebooleanWhether the index enforces uniqueness
schemasarrayList of schemas found in the database

supabase_storage_upload

Upload a file to a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
fileNamestringYesThe name of the file (e.g., "document.pdf", "image.jpg")
pathstringNoOptional folder path (e.g., "folder/subfolder/")
fileDatajsonYesFile to upload - UserFile object (basic mode) or string content (advanced mode: base64 or plain text). Supports data URLs.
contentTypestringNoMIME type of the file (e.g., "image/jpeg", "text/plain")
cacheControlstringNoCache-Control header value in seconds for the stored object (e.g., "3600"; default: "3600")
upsertbooleanNoIf true, overwrites existing file (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectUpload result including file path, bucket, and public URL
↳ IdstringUnique identifier for the uploaded file
↳ KeystringFull object key including bucket name
↳ pathstringPath to the uploaded file within the bucket
↳ bucketstringName of the bucket the file was uploaded to
↳ publicUrlstringPublic URL for the uploaded file

supabase_storage_download

Download a file from a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file to download (e.g., "folder/file.jpg")
fileNamestringNoOptional filename override
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files

supabase_storage_list

List files in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringNoThe folder path to list files from (default: root)
limitnumberNoMaximum number of files to return (default: 100)
offsetnumberNoNumber of files to skip (for pagination)
sortBystringNoColumn to sort by: name, created_at, updated_at, last_accessed_at (default: name)
sortOrderstringNoSort order: asc or desc (default: asc)
searchstringNoSearch term to filter files by name
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of file objects with metadata
↳ idstringUnique file identifier
↳ namestringFile name
↳ bucket_idstringBucket identifier the file belongs to
↳ ownerstringOwner identifier
↳ created_atstringFile creation timestamp
↳ updated_atstringLast update timestamp
↳ last_accessed_atstringLast access timestamp
↳ metadataobjectFile metadata including size and MIME type
↳ sizenumberFile size in bytes
↳ mimetypestringMIME type of the file
↳ cacheControlstringCache control header value
↳ lastModifiedstringLast modified timestamp
↳ eTagstringEntity tag for caching

supabase_storage_delete

Delete files from a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathsarrayYesArray of file paths to delete (e.g., ["folder/file1.jpg", "folder/file2.jpg"])
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of deleted file objects
↳ namestringName of the deleted file
↳ bucket_idstringBucket identifier
↳ ownerstringOwner identifier
↳ idstringUnique file identifier
↳ updated_atstringLast update timestamp
↳ created_atstringFile creation timestamp
↳ last_accessed_atstringLast access timestamp

supabase_storage_move

Move a file within a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
fromPathstringYesThe current path of the file (e.g., "folder/old.jpg")
toPathstringYesThe new path for the file (e.g., "newfolder/new.jpg")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectMove operation result
↳ messagestringOperation status message
↳ IdstringIdentifier of the destination object
↳ KeystringFull object key of the destination

supabase_storage_copy

Copy a file within a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
fromPathstringYesThe path of the source file (e.g., "folder/source.jpg")
toPathstringYesThe path for the copied file (e.g., "folder/copy.jpg")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectCopy operation result with the destination object key
↳ KeystringFull object key of the copied file
↳ IdstringIdentifier of the copied object

supabase_storage_create_bucket

Create a new storage bucket in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the bucket to create
isPublicbooleanNoWhether the bucket should be publicly accessible (default: false)
fileSizeLimitnumberNoMaximum file size in bytes (optional)
allowedMimeTypesarrayNoArray of allowed MIME types (e.g., ["image/png", "image/jpeg"])
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectCreated bucket information
↳ namestringCreated bucket name

supabase_storage_list_buckets

List all storage buckets in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of bucket objects
↳ idstringUnique bucket identifier
↳ namestringBucket name
↳ ownerstringOwner identifier
↳ publicbooleanWhether the bucket is publicly accessible
↳ created_atstringBucket creation timestamp
↳ updated_atstringLast update timestamp
↳ file_size_limitnumberMaximum file size allowed in bytes
↳ allowed_mime_typesarrayList of allowed MIME types for uploads

supabase_storage_delete_bucket

Delete a storage bucket in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the bucket to delete
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectDelete bucket operation result
↳ messagestringOperation status message

supabase_storage_get_public_url

Get the public URL for a file in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file (e.g., "folder/file.jpg")
downloadbooleanNoIf true, forces download instead of inline display (default: false)
outputstringNoNo description

Output

ParameterTypeDescription
messagestringOperation status message
publicUrlstringThe public URL to access the file

supabase_storage_create_signed_url

Create a temporary signed URL for a file in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file (e.g., "folder/file.jpg")
expiresInnumberYesNumber of seconds until the URL expires (e.g., 3600 for 1 hour)
downloadbooleanNoIf true, forces download instead of inline display (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
signedUrlstringThe temporary signed URL to access the file

On this page