Q21: How do you trigger On-Demand ISR Revalidation in the Pages Router?
On-Demand Revalidation purges static cache files immediately via an API route without waiting for the revalidate timer to expire. Call res.revalidate('/target-page-path') inside an authenticated API route handler.
API Route Revalidation Handler
// pages/api/revalidate.js
export default async function handler(req, res) {
if (req.query.secret !== process.env.MY_SECRET_TOKEN) {
return res.status(401).json({ message: 'Invalid token' });
}
try {
await res.revalidate('/posts/1');
return res.json({ revalidated: true });
} catch (err) {
return res.status(500).send('Error revalidating');
}
}💡 res.revalidate immediately rebuilds the target static page cache.
Key Takeaways
- Purges static page cache instantly on content updates.
- Triggered via
res.revalidate('/path')inside API routes.
Knowledge Check
Which response method triggers On-Demand Revalidation inside a Pages Router API route?