---
title: Pause your project
description: Use a webhook to pause your project based on spend management.
url: /kb/guide/pause-your-project
canonical_url: "https://vercel.com/kb/guide/pause-your-project"
published: 2025-11-03
last_updated: 2025-11-11
authors: DX Team
related:
  - /docs/spend-management
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---
<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [Pause a project](https://vercel.com/docs/rest-api/projects/pause-a-project?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=related) — POST /v1/projects/{projectId}/pause — Pause a project by passing its project \\`id\\` in the URL. If the project does not
- [Unpause a project](https://vercel.com/docs/rest-api/projects/unpause-a-project?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=related) — POST /v1/projects/{projectId}/unpause — Unpause a project by passing its project \\`id\\` in the URL. If the project does
- [Managing projects](https://vercel.com/docs/projects/managing-projects?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=related) — Learn how to manage your projects through the Vercel Dashboard.
- [Introducing Spend Management](https://vercel.com/blog/introducing-spend-management-realtime-usage-alerts-sms-notifications?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=related)
- [Update the rolling release settings for the project](https://vercel.com/docs/rest-api/rolling-release/update-the-rolling-release-settings-for-the-project?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=related) — PATCH /v1/projects/{idOrName}/rolling-release/config — Update \\(or disable\\) Rolling Releases for a project. When disabl
- [Delete a Project](https://vercel.com/docs/rest-api/projects/delete-a-project?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=related) — DELETE /v9/projects/{idOrName} — Delete a specific project by passing either the project \\`id\\` or \\`name\\` in the URL.
- [Why has my account or deployment been paused?](https://vercel.com/kb/guide/why-is-my-account-deployment-blocked?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=related) — Learn why a Vercel account or deployment gets paused, from budget and usage limits to policy violations, and how to resu

Full cross-link map for this page: [/kb/guide/pause-your-project.graph.md](/kb/guide/pause-your-project.graph.md?from=related&source_path=%2Fkb%2Fguide%2Fpause-your-project&source_site=vercel-kb&relationship=graph)
<!-- /docsgraph:related -->


You can [pause your project](/docs/spend-management#pausing-projects) through the REST API. When you set up [spend management](/docs/spend-management), you can [trigger a webhook](/docs/spend-management#configuring-a-webhook) which calls the REST API with the following code:

```ts
export async function POST(request: Request) {
  const projectId = 'your project id';
  const teamID = 'your team id';
  const route = `${projectId}/pause?teamID=${teamID}`;

  await fetch(`https://api.vercel.com/v1/projects/${route}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${process.env.VERCEL_TOKEN}`,
    },
  });

  return new Response('Project paused', { status: 200 });
}
```