Supabase Auth Client
API Contract
REST
/api/v1/auth-clients
5 endpoints
GET
/api/v1/auth-clients/api/v1/auth-clients
List all registered Supabase auth client configurations.
Public
Response Example
{
"data": [
{
"id": "client_2b3c4d5e6f7g8h9i",
"url": "https://xyzcompany.supabase.co",
"anon_key_prefix": "eyJhbGciOiJIUzI1...",
"status": "active",
"initialized_at": "2026-03-26T09:00:00.000Z",
"created_at": "2026-03-26T09:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1
}
}
GET
/api/v1/auth-clients/api/v1/auth-clients/:id
Get the configuration and status of a specific Supabase auth client.
Public
Response Example
{
"id": "client_2b3c4d5e6f7g8h9i",
"url": "https://xyzcompany.supabase.co",
"anon_key_prefix": "eyJhbGciOiJIUzI1...",
"status": "active",
"auth_config": {
"auto_refresh_token": true,
"persist_session": true,
"detect_session_in_url": false
},
"initialized_at": "2026-03-26T09:00:00.000Z",
"created_at": "2026-03-26T09:00:00.000Z"
}
POST
/api/v1/auth-clients/api/v1/auth-clients
Initialize a new Supabase auth client with URL and anon key (initialize()). Returns client configuration.
Public
Request Example
{
"url": "https://xyzcompany.supabase.co",
"anon_key": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Inh5emNvbXBhbnkiLCJyb2xlIjoiYW5vbiJ9.AbC1dE2fG3hI4jK5lM6nO7pQ8rS9tU0vW1x",
"auth_config": {
"auto_refresh_token": true,
"persist_session": true,
"detect_session_in_url": false
}
}
Response Example
{
"id": "client_2b3c4d5e6f7g8h9i",
"url": "https://xyzcompany.supabase.co",
"anon_key_prefix": "eyJhbGciOiJIUzI1...",
"status": "active",
"auth_config": {
"auto_refresh_token": true,
"persist_session": true,
"detect_session_in_url": false
},
"initialized_at": "2026-03-26T09:00:00.000Z",
"created_at": "2026-03-26T09:00:00.000Z"
}
PUT
/api/v1/auth-clients/api/v1/auth-clients/:id
Update Supabase auth client configuration (e.g. rotate anon key or change auth settings).
Public
Request Example
{
"auth_config": {
"auto_refresh_token": true,
"persist_session": false,
"detect_session_in_url": false
}
}
Response Example
{
"id": "client_2b3c4d5e6f7g8h9i",
"url": "https://xyzcompany.supabase.co",
"anon_key_prefix": "eyJhbGciOiJIUzI1...",
"status": "active",
"auth_config": {
"auto_refresh_token": true,
"persist_session": false,
"detect_session_in_url": false
},
"updated_at": "2026-03-26T16:00:00.000Z"
}
DELETE
/api/v1/auth-clients/api/v1/auth-clients/:id
Dispose and deregister a Supabase auth client (dispose()). Frees all underlying connections.
Public
Response Example
{
"deleted": true,
"id": "client_2b3c4d5e6f7g8h9i",
"disposed_at": "2026-03-26T16:30:00.000Z"
}