Files
supabase/apps/docs/spec/supabase_js_v2.yml
Katerina Skroumpelou 89e291adec docs: prefer publishable/secret key naming in SDK specs (#45372)
## Description

Replaces legacy `anon` / `service_role` key references with the new
`publishable` / `secret` naming across SDK spec files under
`apps/docs/spec/`. Mirrors the rename table established by
[supabase-js#2280](https://github.com/supabase/supabase-js/pull/2280),
so the auto-generated reference docs at
supabase.com/docs/reference/{js,dart,kotlin,python,swift} stay
consistent with the SDK source.

## Files changed

| File | Highlights |
| --- | --- |
| `supabase_js_v2.yml` | Rename example vars `anon_key` →
`publishable_key`, `service_role_key` → `secret_key`; admin notes use
`secret`. |
| `supabase_dart_v2.yml` | Rename `anonKey` param → `publishableKey`
(matches the live Flutter SDK — see
[supabase-flutter/supabase.dart#L81](https://github.com/supabase/supabase-flutter/blob/main/packages/supabase_flutter/lib/src/supabase.dart#L81));
update call-site; example var `serviceRoleKey` → `secretKey`; admin
notes use `secret`. |
| `supabase_kt_v2.yml`, `supabase_kt_v3.yml` | Replace
`'publishable-or-anon-key'` placeholders with `'your-publishable-key'`;
admin notes use `secret`; fix `importAuthToken(\"service_role\")` →
`importAuthToken(\"your-secret-key\")` (the Kotlin SDK's
`importAuthToken(accessToken: String, …)` takes a JWT, not a role name).
|
| `supabase_py_v2.yml` | All `service_role` references → `secret`;
example var `service_role_key` → `secret_key`. |
| `supabase_swift_v2.yml` | Replace placeholders with
`'your-publishable-key'`; admin notes use `secret`; example var
`serviceRoleKey` → `secretKey`. |
| `storage_v0_config.yaml` | Rewrite `ANON_KEY` / `SERVICE_KEY` env var
**descriptions** in publishable/secret terms. **Env var names kept** —
see below. |

## Why the storage env var names are unchanged

`storage_v0_config.yaml` documents the env vars used to configure the
storage server (multi-tenant deployments). The `id` and `title` fields
must match the actual env var names the binary reads. The storage server
still reads its config from env vars literally named `ANON_KEY` and
`SERVICE_KEY`:

-
[`storage/src/config.ts#L614`](https://github.com/supabase/storage/blob/master/src/config.ts#L614)
— `getOptionalConfigFromEnv('SERVICE_KEY')`
-
[`storage/src/config.ts#L625`](https://github.com/supabase/storage/blob/master/src/config.ts#L625)
— `getOptionalConfigFromEnv('ANON_KEY')`

There is no `PUBLISHABLE_KEY` / `SECRET_KEY` reader on master. Renaming
the doc IDs would break self-hosted deployments — users following the
docs would set the wrong env var and the storage server would silently
fall back to generating its own JWT. Until the storage server itself
adds publishable/secret env support, only descriptions can be updated.

(Same reasoning for not bumping `storage_v0_config.yaml` →
`storage_v1_config.yaml`: the `_v0_` tracks the storage server's own API
version, paired with `storage_v0_openapi.json` downloaded from
`supabase.github.io/storage/api.json`. The server hasn't shipped a v1
API.)

## What we deliberately did NOT rename

Per the same rules established in supabase-js#2280:

- **JWT role claims** like `role: 'anon'` / `role: 'service_role'` —
these are functional Postgres role names in JWT payloads, not key
labels.
- **Real SDK identifiers** that haven't been renamed in the source (we
only rename in the doc when the underlying SDK rename has shipped). The
Dart `anonKey` rename was safe to apply because the Flutter SDK already
ships `publishableKey` as the preferred named parameter (with `anonKey`
`@Deprecated`).

## Out of scope

- **All `*_v1.yml` SDK spec files** (`supabase_js_v1`,
`supabase_dart_v1`, `supabase_kt_v1`, `supabase_swift_v1`). Older SDK
versions, not worth churning.
- **`cli_v1_commands.yaml`**. This file is auto-generated by the CLI
repo's release workflow
([`cli/tools/bumpdoc/main.go`](https://github.com/supabase/cli/blob/develop/tools/bumpdoc/main.go))
and the example outputs come from
[`cli/docs/templates/examples.yaml`](https://github.com/supabase/cli/blob/develop/docs/templates/examples.yaml)
— embedded in the CLI binary at build time. Any edits we make here would
be clobbered by the next CLI release. The fix needs to land upstream in
the CLI repo (note: the CLI itself already ships publishable/secret
naming in \`supabase status\` output — see
[`cli/internal/status/status.go#L40-L44`](https://github.com/supabase/cli/blob/develop/internal/status/status.go#L40-L44)
— but the doc-generation template is stale).
- **`supabase_csharp_v0.yml` / `supabase_csharp_v1.yml`** — checked,
already neutral. Both files use a generic `SUPABASE_KEY` env var with no
`anon` / `service_role` references.
- **Renaming the legacy Dart `anonKey` parameter itself** — that's an
SDK-side change. The Flutter SDK already exposes `publishableKey` as the
preferred parameter; full removal of `anonKey` will happen in a future
major version per the SDK's own deprecation comment.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Standardized API key naming across SDK docs: use publishable (client)
and secret (server/admin) key terminology
* Updated server-side admin examples and warnings to require secret keys
and emphasize never exposing them in client code
* Unified initialization examples across JavaScript, Dart, Kotlin,
Python, and Swift
* Corrected Storage spec metadata to point to the proper configuration
file
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
2026-05-04 09:36:05 +03:00

664 lines
27 KiB
YAML

openref: 0.1
info:
id: reference/supabase-js
title: Supabase Javascript Client
description: |
Supabase JavaScript.
definition: spec/enrichments/tsdoc_v2/combined.json
specUrl: https://github.com/supabase/supabase/edit/master/apps/docs/spec/supabase_js_v2.yml
slugPrefix: /
libraries:
- id: JavaScript
version: 0.0.1
functions:
- id: initializing
$ref: '@supabase/supabase-js.SupabaseClient.constructor'
- id: auth-api
title: Overview
notes: |
- The auth methods can be accessed via the `supabase.auth` namespace.
- By default, the supabase client sets `persistSession` to true and attempts to store the session in local storage. When using the supabase client in an environment that doesn't support local storage, you might notice the following warning message being logged:
> No storage option exists to persist the session, which may result in unexpected behavior when using auth. If you want to set `persistSession` to true, please provide a storage option or you may set `persistSession` to false to disable this warning.
This warning message can be safely ignored if you're not using auth on the server-side. If you are using auth and you want to set `persistSession` to true, you will need to provide a custom storage implementation that follows [this interface](https://github.com/supabase/supabase-js/blob/master/packages/core/auth-js/src/lib/types.ts#L1053).
- Any email links and one-time passwords (OTPs) sent have a default expiry of 24 hours. We have the following [rate limits](/docs/guides/platform/going-into-prod#auth-rate-limits) in place to guard against brute force attacks.
- The expiry of an access token can be set in the "JWT expiry limit" field in [your project's auth settings](/dashboard/project/_/auth/providers). A refresh token never expires and can only be used once.
examples:
- id: create-auth-client
name: Create auth client
isSpotlight: true
code: |
```js
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(supabase_url, publishable_key)
```
- id: create-auth-client-server-side
name: Create auth client (server-side)
isSpotlight: false
code: |
```js
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(supabase_url, publishable_key, {
auth: {
autoRefreshToken: false,
persistSession: false,
detectSessionInUrl: false
}
})
```
- id: sign-up
$ref: '@supabase/auth-js.GoTrueClient.signUp'
- id: on-auth-state-change
$ref: '@supabase/auth-js.GoTrueClient.onAuthStateChange'
- id: sign-in-anonymously
$ref: '@supabase/auth-js.GoTrueClient.signInAnonymously'
- id: sign-in-with-password
$ref: '@supabase/auth-js.GoTrueClient.signInWithPassword'
- id: sign-in-with-otp
$ref: '@supabase/auth-js.GoTrueClient.signInWithOtp'
- id: sign-in-with-oauth
$ref: '@supabase/auth-js.GoTrueClient.signInWithOAuth'
- id: sign-in-with-id-token
$ref: '@supabase/auth-js.GoTrueClient.signInWithIdToken'
- id: sign-in-with-sso
$ref: '@supabase/auth-js.GoTrueClient.signInWithSSO'
- id: sign-in-with-web3
$ref: '@supabase/auth-js.GoTrueClient.signInWithWeb3'
- id: sign-in-with-passkey
$ref: '@supabase/auth-js.GoTrueClient.signInWithPasskey'
- id: register-passkey
$ref: '@supabase/auth-js.GoTrueClient.registerPasskey'
- id: get-claims
$ref: '@supabase/auth-js.GoTrueClient.getClaims'
- id: sign-out
$ref: '@supabase/auth-js.GoTrueClient.signOut'
- id: verify-otp
$ref: '@supabase/auth-js.GoTrueClient.verifyOtp'
- id: get-session
$ref: '@supabase/auth-js.GoTrueClient.getSession'
- id: start-auto-refresh
$ref: '@supabase/auth-js.GoTrueClient.startAutoRefresh'
- id: stop-auto-refresh
$ref: '@supabase/auth-js.GoTrueClient.stopAutoRefresh'
- id: get-user
$ref: '@supabase/auth-js.GoTrueClient.getUser'
- id: update-user
$ref: '@supabase/auth-js.GoTrueClient.updateUser'
- id: get-user-identities
$ref: '@supabase/auth-js.GoTrueClient.getUserIdentities'
- id: link-identity
$ref: '@supabase/auth-js.GoTrueClient.linkIdentity'
- id: unlink-identity
$ref: '@supabase/auth-js.GoTrueClient.unlinkIdentity'
- id: send-password-reauthentication
$ref: '@supabase/auth-js.GoTrueClient.reauthenticate'
- id: resend-email-or-phone-otps
$ref: '@supabase/auth-js.GoTrueClient.resend'
- id: set-session
$ref: '@supabase/auth-js.GoTrueClient.setSession'
- id: refresh-session
$ref: '@supabase/auth-js.GoTrueClient.refreshSession'
- id: exchange-code-for-session
$ref: '@supabase/auth-js.GoTrueClient.exchangeCodeForSession'
- id: auth-js-gotrueclient-initialize
$ref: '@supabase/auth-js.GoTrueClient.initialize'
- id: auth-mfa-api
title: Overview
notes: |
This section contains methods commonly used for Multi-Factor Authentication (MFA) and are invoked behind the `supabase.auth.mfa` namespace.
Currently, there is support for time-based one-time password (TOTP) and phone verification code as the 2nd factor. Recovery codes are not supported but users can enroll multiple factors, with an upper limit of 10.
Having a 2nd factor for recovery frees the user of the burden of having to store their recovery codes somewhere. It also reduces the attack surface since multiple recovery codes are usually generated compared to just having 1 backup factor.
Learn more about implementing MFA in your application [in the MFA guide](https://supabase.com/docs/guides/auth/auth-mfa#overview).
- id: mfa-enroll
$ref: '@supabase/auth-js.GoTrueMFAApi.enroll'
- id: mfa-challenge
$ref: '@supabase/auth-js.GoTrueMFAApi.challenge'
- id: mfa-verify
$ref: '@supabase/auth-js.GoTrueMFAApi.verify'
- id: mfa-challenge-and-verify
$ref: '@supabase/auth-js.GoTrueMFAApi.challengeAndVerify'
- id: mfa-unenroll
$ref: '@supabase/auth-js.GoTrueMFAApi.unenroll'
- id: mfa-get-authenticator-assurance-level
$ref: '@supabase/auth-js.GoTrueMFAApi.getAuthenticatorAssuranceLevel'
- id: passkey-api
title: Auth Passkey
notes: |
This section contains methods for WebAuthn passkey registration, authentication, and management. Methods are invoked behind the `supabase.auth.passkey` namespace.
Passkey support is an experimental feature. Enable it when creating the client:
```ts
const supabase = createClient(supabaseUrl, publishableKey, {
auth: {
experimental: { passkey: true },
},
})
```
- id: passkey-list
$ref: '@supabase/auth-js.AuthPasskeyApi.list'
- id: passkey-update
$ref: '@supabase/auth-js.AuthPasskeyApi.update'
- id: passkey-delete
$ref: '@supabase/auth-js.AuthPasskeyApi.delete'
- id: passkey-start-registration
$ref: '@supabase/auth-js.AuthPasskeyApi.startRegistration'
- id: passkey-verify-registration
$ref: '@supabase/auth-js.AuthPasskeyApi.verifyRegistration'
- id: passkey-start-authentication
$ref: '@supabase/auth-js.AuthPasskeyApi.startAuthentication'
- id: passkey-verify-authentication
$ref: '@supabase/auth-js.AuthPasskeyApi.verifyAuthentication'
- id: admin-api
title: Overview
notes: |
- Any method under the `supabase.auth.admin` namespace requires a `secret` key.
- These methods are considered admin methods and should be called on a trusted server. Never expose your `secret` key in the browser.
examples:
- id: create-auth-admin-client
name: Create server-side auth client
isSpotlight: true
code: |
```js
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(supabase_url, secret_key, {
auth: {
autoRefreshToken: false,
persistSession: false
}
})
// Access auth admin api
const adminAuthClient = supabase.auth.admin
```
- id: get-user-by-id
$ref: '@supabase/auth-js.GoTrueAdminApi.getUserById'
- id: list-users
$ref: '@supabase/auth-js.GoTrueAdminApi.listUsers'
- id: create-user
$ref: '@supabase/auth-js.GoTrueAdminApi.createUser'
- id: delete-user
$ref: '@supabase/auth-js.GoTrueAdminApi.deleteUser'
- id: invite-user-by-email
$ref: '@supabase/auth-js.GoTrueAdminApi.inviteUserByEmail'
- id: reset-password-for-email
$ref: '@supabase/auth-js.GoTrueClient.resetPasswordForEmail'
- id: generate-link
$ref: '@supabase/auth-js.GoTrueAdminApi.generateLink'
- id: update-user-by-id
$ref: '@supabase/auth-js.GoTrueAdminApi.updateUserById'
- id: auth-js-gotrueadminapi-signout
$ref: '@supabase/auth-js.GoTrueAdminApi.signOut'
- id: mfa-list-factors-admin
$ref: '@supabase/auth-js.GoTrueAdminMFAApi.listFactors'
- id: mfa-delete-factor
$ref: '@supabase/auth-js.GoTrueAdminMFAApi.deleteFactor'
- id: admin-passkey-api
title: Passkey Admin API
notes: |
Contains passkey administration methods. Requires a secret key.
- id: admin-list-passkeys
$ref: '@supabase/auth-js.GoTrueAdminPasskeyApi.listPasskeys'
- id: admin-delete-passkey
$ref: '@supabase/auth-js.GoTrueAdminPasskeyApi.deletePasskey'
- id: admin-custom-providers-api
title: Custom OIDC/OAuth Provider Admin API
notes: |
- These methods allow you to manage custom OIDC/OAuth providers programmatically.
- Requires `secret` key.
- Custom providers use the `custom:` prefix when signing in (e.g., `custom:my-oidc-provider`).
- id: admin-custom-providers-create
$ref: '@supabase/auth-js.GoTrueAdminCustomProvidersApi.createProvider'
- id: admin-custom-providers-list
$ref: '@supabase/auth-js.GoTrueAdminCustomProvidersApi.listProviders'
- id: admin-custom-providers-get
$ref: '@supabase/auth-js.GoTrueAdminCustomProvidersApi.getProvider'
- id: admin-custom-providers-update
$ref: '@supabase/auth-js.GoTrueAdminCustomProvidersApi.updateProvider'
- id: admin-custom-providers-delete
$ref: '@supabase/auth-js.GoTrueAdminCustomProvidersApi.deleteProvider'
- id: select
$ref: '@supabase/postgrest-js.PostgrestQueryBuilder.select'
- id: insert
$ref: '@supabase/postgrest-js.PostgrestQueryBuilder.insert'
- id: update
$ref: '@supabase/postgrest-js.PostgrestQueryBuilder.update'
- id: upsert
$ref: '@supabase/postgrest-js.PostgrestQueryBuilder.upsert'
- id: delete
$ref: '@supabase/postgrest-js.PostgrestQueryBuilder.delete'
- id: rpc
$ref: '@supabase/postgrest-js.PostgrestClient.rpc'
- id: using-filters
title: Using Filters
description: |
Filters allow you to only return rows that match certain conditions.
Filters can be used on `select()`, `update()`, `upsert()`, and `delete()` queries.
If a Postgres function returns a table response, you can also apply filters.
examples:
- id: applying-filters
name: Applying Filters
description: |
Filters must be applied after any of `select()`, `update()`, `upsert()`,
`delete()`, and `rpc()` and before
[modifiers](/docs/reference/javascript/using-modifiers).
code: |
```ts
const { data, error } = await supabase
.from('instruments')
.select('name, section_id')
.eq('name', 'violin') // Correct
const { data, error } = await supabase
.from('instruments')
.eq('name', 'violin') // Incorrect
.select('name, section_id')
```
- id: chaining-filters
name: Chaining
description: |
Filters can be chained together to produce advanced queries. For example,
to query cities with population between 1,000 and 10,000:
```ts
const { data, error } = await supabase
.from('cities')
.select('name, country_id')
.gte('population', 1000)
.lt('population', 10000)
```
code: |
```ts
const { data, error } = await supabase
.from('cities')
.select('name, country_id')
.gte('population', 1000)
.lt('population', 10000)
```
- id: conditional-chaining
name: Conditional Chaining
description: |
Filters can be built up one step at a time and then executed. For example:
```ts
const filterByName = null
const filterPopLow = 1000
const filterPopHigh = 10000
let query = supabase
.from('cities')
.select('name, country_id')
if (filterByName) { query = query.eq('name', filterByName) }
if (filterPopLow) { query = query.gte('population', filterPopLow) }
if (filterPopHigh) { query = query.lt('population', filterPopHigh) }
const { data, error } = await query
```
code: |
```ts
const filterByName = null
const filterPopLow = 1000
const filterPopHigh = 10000
let query = supabase
.from('cities')
.select('name, country_id')
if (filterByName) { query = query.eq('name', filterByName) }
if (filterPopLow) { query = query.gte('population', filterPopLow) }
if (filterPopHigh) { query = query.lt('population', filterPopHigh) }
const { data, error } = await query
```
- id: filter-by-value-within-json-column
name: Filter by values within a JSON column
code: |
```ts
const { data, error } = await supabase
.from('users')
.select()
.eq('address->postcode', 90210)
```
data:
sql: |
```sql
create table
users (
id int8 primary key,
name text,
address jsonb
);
insert into
users (id, name, address)
values
(1, 'Michael', '{ "postcode": 90210 }'),
(2, 'Jane', null);
```
response: |
```json
{
"data": [
{
"id": 1,
"name": "Michael",
"address": {
"postcode": 90210
}
}
],
"status": 200,
"statusText": "OK"
}
```
- id: filter-referenced-tables
name: Filter referenced tables
code: |
```ts
const { data, error } = await supabase
.from('orchestral_sections')
.select(`
name,
instruments!inner (
name
)
`)
.eq('instruments.name', 'flute')
```
data:
sql: |
```sql
create table
orchestral_sections (id int8 primary key, name text);
create table
instruments (
id int8 primary key,
section_id int8 not null references orchestral_sections,
name text
);
insert into
orchestral_sections (id, name)
values
(1, 'strings'),
(2, 'woodwinds');
insert into
instruments (id, section_id, name)
values
(1, 2, 'flute'),
(2, 1, 'violin');
```
response: |
```json
{
"data": [
{
"name": "woodwinds",
"characters": [
{
"name": "flute"
}
]
}
],
"status": 200,
"statusText": "OK"
}
```
description: |
You can filter on referenced tables in your `select()` query using dot
notation.
- id: eq
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.eq'
- id: neq
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.neq'
- id: gt
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.gt'
- id: gte
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.gte'
- id: lt
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.lt'
- id: lte
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.lte'
- id: like
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.like'
- id: ilike
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.ilike'
- id: is
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.is'
- id: in
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.in'
- id: contains
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.contains'
- id: contained-by
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.containedBy'
- id: range-gt
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.rangeGt'
- id: range-gte
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.rangeGte'
- id: range-lt
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.rangeLt'
- id: range-lte
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.rangeLte'
- id: range-adjacent
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.rangeAdjacent'
- id: overlaps
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.overlaps'
- id: text-search
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.textSearch'
- id: match
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.match'
- id: not
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.not'
- id: or
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.or'
- id: filter
$ref: '@supabase/postgrest-js.PostgrestFilterBuilder.filter'
- id: using-modifiers
title: Using Modifiers
description: |
Filters work on the row level—they allow you to return rows that
only match certain conditions without changing the shape of the rows.
Modifiers are everything that don't fit that definition—allowing you to
change the format of the response (e.g., returning a CSV string).
Modifiers must be specified after filters. Some modifiers only apply for
queries that return rows (e.g., `select()` or `rpc()` on a function that
returns a table response).
- id: db-modifiers-select
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.select'
- id: order
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.order'
- id: limit
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.limit'
- id: range
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.range'
- id: abort-signal
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.abortSignal'
- id: single
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.single'
- id: maybe-single
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.maybeSingle'
- id: csv
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.csv'
- id: strip-nulls
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.stripNulls'
- id: returns
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.returns'
- id: overrideTypes
$ref: '@supabase/postgrest-js.PostgrestBuilder.overrideTypes'
- id: explain
$ref: '@supabase/postgrest-js.PostgrestTransformBuilder.explain'
- id: invoke
$ref: '@supabase/functions-js.FunctionsClient.invoke'
- id: cors-headers
$ref: '@supabase/supabase-js.cors.corsHeaders'
- id: functions-setauth
$ref: '@supabase/functions-js.FunctionsClient.setAuth'
- id: subscribe
$ref: '@supabase/realtime-js.RealtimeChannel.on'
- id: broadcast-message
$ref: '@supabase/realtime-js.RealtimeChannel.send'
- id: get-channels
$ref: '@supabase/supabase-js.SupabaseClient.getChannels'
- id: remove-channel
$ref: '@supabase/supabase-js.SupabaseClient.removeChannel'
- id: remove-all-channels
$ref: '@supabase/supabase-js.SupabaseClient.removeAllChannels'
- id: realtime-setauth
$ref: '@supabase/realtime-js.RealtimeClient.setAuth'
- id: file-buckets
title: Overview
notes: |
This section contains methods for working with File Buckets.
- id: list-buckets
$ref: '@supabase/storage-js.StorageClient.listBuckets'
- id: get-bucket
$ref: '@supabase/storage-js.StorageClient.getBucket'
- id: create-bucket
$ref: '@supabase/storage-js.StorageClient.createBucket'
- id: empty-bucket
$ref: '@supabase/storage-js.StorageClient.emptyBucket'
- id: update-bucket
$ref: '@supabase/storage-js.StorageClient.updateBucket'
- id: delete-bucket
$ref: '@supabase/storage-js.StorageClient.deleteBucket'
- id: analytics-buckets
title: Overview
notes: |
This section contains methods for working with Analytics Buckets.
- id: storageanalytics-from
$ref: '@supabase/storage-js.packages/StorageAnalyticsClient.default.constructor'
- id: storageanalytics-createbucket
$ref: '@supabase/storage-js.packages/StorageAnalyticsClient.default.createBucket'
- id: storageanalytics-listbuckets
$ref: '@supabase/storage-js.packages/StorageAnalyticsClient.default.listBuckets'
- id: storageanalytics-deletebucket
$ref: '@supabase/storage-js.packages/StorageAnalyticsClient.default.deleteBucket'
- id: from-upload
$ref: '@supabase/storage-js.packages/StorageFileApi.default.upload'
- id: from-update
$ref: '@supabase/storage-js.packages/StorageFileApi.default.update'
- id: from-move
$ref: '@supabase/storage-js.packages/StorageFileApi.default.move'
- id: from-copy
$ref: '@supabase/storage-js.packages/StorageFileApi.default.copy'
- id: from-create-signed-url
$ref: '@supabase/storage-js.packages/StorageFileApi.default.createSignedUrl'
- id: from-create-signed-urls
$ref: '@supabase/storage-js.packages/StorageFileApi.default.createSignedUrls'
- id: from-create-signed-upload-url
$ref: '@supabase/storage-js.packages/StorageFileApi.default.createSignedUploadUrl'
- id: from-upload-to-signed-url
$ref: '@supabase/storage-js.packages/StorageFileApi.default.uploadToSignedUrl'
- id: from-get-public-url
$ref: '@supabase/storage-js.packages/StorageFileApi.default.getPublicUrl'
- id: from-download
$ref: '@supabase/storage-js.packages/StorageFileApi.default.download'
- id: from-remove
$ref: '@supabase/storage-js.packages/StorageFileApi.default.remove'
- id: from-list
$ref: '@supabase/storage-js.packages/StorageFileApi.default.list'
- id: oauth-server-api
title: OAuth Server API
notes: |
The OAuth Server API allows you to build custom OAuth consent screens for your application.
Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.
- id: auth-js-authoauthserverapi-approveauthorization
$ref: '@supabase/auth-js.AuthOAuthServerApi.approveAuthorization'
- id: auth-js-authoauthserverapi-denyauthorization
$ref: '@supabase/auth-js.AuthOAuthServerApi.denyAuthorization'
- id: auth-js-authoauthserverapi-getauthorizationdetails
$ref: '@supabase/auth-js.AuthOAuthServerApi.getAuthorizationDetails'
- id: auth-js-authoauthserverapi-listgrants
$ref: '@supabase/auth-js.AuthOAuthServerApi.listGrants'
- id: auth-js-authoauthserverapi-revokegrant
$ref: '@supabase/auth-js.AuthOAuthServerApi.revokeGrant'
- id: oauth-admin-api
title: OAuth Admin API
notes: |
The OAuth Admin API allows you to manage OAuth clients programmatically.
Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.
These functions should only be called on a server. Never expose your `secret` key in the browser.
- id: auth-js-gotrueadminoauthapi-createclient
$ref: '@supabase/auth-js.GoTrueAdminOAuthApi.createClient'
- id: auth-js-gotrueadminoauthapi-deleteclient
$ref: '@supabase/auth-js.GoTrueAdminOAuthApi.deleteClient'
- id: auth-js-gotrueadminoauthapi-getclient
$ref: '@supabase/auth-js.GoTrueAdminOAuthApi.getClient'
- id: auth-js-gotrueadminoauthapi-listclients
$ref: '@supabase/auth-js.GoTrueAdminOAuthApi.listClients'
- id: auth-js-gotrueadminoauthapi-regenerateclientsecret
$ref: '@supabase/auth-js.GoTrueAdminOAuthApi.regenerateClientSecret'
- id: auth-js-gotrueadminoauthapi-updateclient
$ref: '@supabase/auth-js.GoTrueAdminOAuthApi.updateClient'
- id: auth-js-gotruemfaapi-listfactors
$ref: '@supabase/auth-js.GoTrueMFAApi.listFactors'
- id: storageclient-from
$ref: '@supabase/storage-js.StorageClient.from'
- id: create-bucket
$ref: '@supabase/storage-js.index.StorageClient.createBucket'
- id: delete-bucket
$ref: '@supabase/storage-js.index.StorageClient.deleteBucket'
- id: empty-bucket
$ref: '@supabase/storage-js.index.StorageClient.emptyBucket'
- id: get-bucket
$ref: '@supabase/storage-js.index.StorageClient.getBucket'
- id: list-buckets
$ref: '@supabase/storage-js.index.StorageClient.listBuckets'
- id: update-bucket
$ref: '@supabase/storage-js.index.StorageClient.updateBucket'
- id: storagevectors-create-bucket
$ref: '@supabase/storage-js.packages/StorageVectorsClient.StorageVectorsClient.createBucket'
- id: storagevectors-delete-bucket
$ref: '@supabase/storage-js.packages/StorageVectorsClient.StorageVectorsClient.deleteBucket'
- id: storagevectors-get-bucket
$ref: '@supabase/storage-js.packages/StorageVectorsClient.StorageVectorsClient.getBucket'
- id: storagevectors-list-buckets
$ref: '@supabase/storage-js.packages/StorageVectorsClient.StorageVectorsClient.listBuckets'
- id: storagevectors-from
$ref: '@supabase/storage-js.packages/StorageVectorsClient.StorageVectorsClient.from'
- id: vectorbucket-index
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorBucketScope.index'
- id: storagefile-exists
$ref: '@supabase/storage-js.packages/StorageFileApi.default.exists'
- id: storagefile-info
$ref: '@supabase/storage-js.packages/StorageFileApi.default.info'
- id: storagefile-list-v2
$ref: '@supabase/storage-js.packages/StorageFileApi.default.listV2'
- id: storagefile-to-base64
$ref: '@supabase/storage-js.packages/StorageFileApi.default.toBase64'
- id: vector-buckets
title: Overview
notes: |
This section contains methods for working with Vector Buckets.
- id: vectorbucket-createindex
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorBucketScope.createIndex'
- id: vectorbucket-deleteindex
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorBucketScope.deleteIndex'
- id: vectorbucket-getindex
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorBucketScope.getIndex'
- id: vectorbucket-listindexes
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorBucketScope.listIndexes'
- id: vectorindex-deletevectors
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorIndexScope.deleteVectors'
- id: vectorindex-getvectors
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorIndexScope.getVectors'
- id: vectorindex-listvectors
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorIndexScope.listVectors'
- id: vectorindex-putvectors
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorIndexScope.putVectors'
- id: vectorindex-queryvectors
$ref: '@supabase/storage-js.packages/StorageVectorsClient.VectorIndexScope.queryVectors'