Edge Function 404 error response

[supabase-search[bot]]

This is a copy of a troubleshooting article on Supabase's docs site. It may be missing some details from the original. View the original article.

The edge function is not recognized by Supabase

Context for the error

If the Supabase Edge Function Runtime does not recognize the function specified in the URL endpoint:

https://PROJECT_REF.supabase.co/functions/v1/UNRECOGNIZED_FUNCTION_NAME

then the runtime will return a 404 error.

Solving the error

Step 1: Identifying the error

Inspecting the return message from the request

When an edge function fails due to a platform 404 error, it will return the error:

{
  "code": "NOT_FOUND",
  "message": "Requested function was not found"
}

Inspecting the logs

You cannot inspect the function dashboard to find platform 404 errors, instead, run the below query in the log explorer. The results show all requests that reached Supabase but were rejected as unrecognizable.

select distinct
  req.pathname as function_name,
  res.status_code,
  case
    when metadata.execution_id is null then 'FUNCTION_NOT_FOUND'
    else 'FUNCTION RECOGNIZED: custom 404 message in app logic'
  end as type_of_404
from
  function_edge_logs
  cross join UNNEST(metadata) as metadata
  cross join UNNEST(metadata.request) as req
  cross join UNNEST(metadata.response) as res
where status_code = 404
limit 10;

Step 2: Check the function for typos

In your code, make sure your function name doesn't have any typos, such as:

• miscapitalization
• em-dashes instead of dashes
• misplaced characters
• unnecessary slashes ///

Step 3: Try calling the function from the dashboard

When selecting your function in the Function Dashboard, you should have the option to make a test call:

If the call works, consider double checking your code for typos or to see if it is overwriting the function name dynamically. Otherwise, go on to step 4.

Step 4: Redeploy the function

If step 3 fails, it may be a sign of an internal bug and it may be necessary to redeploy your function. This can be done within the Function Dashboard under the respective function's code tab:

Alternatively, if you develop locally, you can redeploy the function with the Supabase CLI:

supabase functions deploy FUNCTION_NAME

# If you want to deploy all functions, run the `deploy` command without specifying a function name:
supabase functions deploy

Then write in a ticket to Supabase Support

Additional resources

• Securing Edge Functions
• Debugging Edge Functions
• Quickstart Deployment: Dashboard
• Quickstart Deployment: CLI