Fixing 520 Errors in the Database REST API

Last edited: 1/17/2025

In the context of the database API, Cloudflare 520 errors most often occur when 16+KB worth of data is present in the headers/URL of your requests.

The API will include filters within the URL, so a request like so:

1
let { data: countries, error } = await supabase.from('countries').select('name')

translates to a URL like:

1
https://<project ref>.supabase.co/rest/v1/countries?select=name

However, appending too much data to the URL can exceed the 16KB limitation, triggering a 520 failure. This typically occurs with lengthy in clauses, as demonstrated here:

1
2
3
4
const { data, error } = await supabase .from('countries') .select() .not('id', 'in', '(5,6,7,8,9,...10,000)')

To circumvent this issue, you must use RPCs. They are database functions that you can call from the API. Instead of including a query's structure within the URL or header, they move it into the request's payload.

Here is a basic example of a database function

1
2
3
4
5
6
7
8
9
create or replace function example(id uuid[])returns uuid[]language plpgsqlas $$begin raise log 'the function example was called with an array size of: %', (select array_length(id, 1)); return id;end;$$;

The RPC can then call the function with an array that contains more than 16KB of data

1
const { data, error } = await supabase.rpc('example', { id: ['e2f34fb9-bbf9-4649-9b2f-09ec56e67a42', ...900 more UUIDs] })