---
title: "Pause a project"
method: POST
path: "/v1/apps/{appId}/pause"
tags: ["Projects"]
deprecated: true
---

# Pause a project

`POST /v1/apps/{appId}/pause`

## Request

- Base URL: `https://api.spice.ai`
- URL: `https://api.spice.ai/v1/apps/{appId}/pause`
- Auth: HTTP bearer

> **Deprecated.**

Legacy alias of `/v1/projects/{projectId}/pause`. Projects were previously called apps. Pauses the project's running spicepod. The runtime is torn down and the
spicepod record is marked as paused. Settings and configuration are
preserved. Resume with POST /v1/projects/{projectId}/resume. Requires
`apps:write`.

## Path parameters

- `appId` integer, required

## Headers

- `X-Org-Name` string

## Response `200`

Project paused

- object
  - `id` integer, required: The project ID
  - `name` string, required: The project name
  - `paused_at` string, date-time, required: Timestamp when the project was paused

## Other responses

- `400`: Invalid project ID, missing API key, no spicepod configured, or spicepod has been deleted
- `401`: Unauthorized
- `403`: Insufficient scope
- `404`: Project not found
- `409`: Project is already paused
- `500`: Internal server error

---

[API](https://skmtc.dev/spice/apis/spice-cloud-control-plane-api.md) - [All operations](https://skmtc.dev/spice/apis/spice-cloud-control-plane-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spice/apis/spice-cloud-control-plane-api/revisions/5f3b75dd847d?raw)
