Next.jshard

Route Handler vs Server Action — how do you choose?

Answer

Use Server Actions for server-only mutations tied to forms/UI (you still validate and authorize). Use Route Handlers when you need a general HTTP API (public clients, webhooks, third parties, custom methods/headers) or non-form flows like uploads.

Related questions

Next.js

Route Handlers in the App Router: how do you define them and what are they used for?

#nextjs#route-handlers#api

Next.js

Cache invalidation: what do `revalidatePath` and `revalidateTag` do?

#nextjs#cache#revalidate

Next.js

Server Actions (`'use server'`): what are they and what are common restrictions?

#nextjs#server-actions#mutations

Next.js

Next.js App Router auth: how do you keep it secure and SSR-friendly?

#nextjs#auth#cookies

Next.js

Environment variables in Next.js: what does `NEXT_PUBLIC_` mean?

#nextjs#env#security

Next.js

What is a Route Handler (`route.ts`) and when would you use it?

#route-handlers#api#app-router