> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Stop Application

> Shut down your application.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

Shuts down a running application without deleting it: the container stops, but the application's files, environment variables, and configuration are kept, so it can be started again at any time with [Start Application](/en/api-reference/endpoint/apps/start). It is a no-op if the application is already stopped.

This is the endpoint to reach for when you want to free up an application's resources temporarily, for example pausing a background worker outside business hours, without giving up the application slot the way [Delete Application](/en/api-reference/endpoint/apps/delete) would. On workspace-shared applications, the caller needs the Manager, Maintainer, or Administrator role.

The request is rate limited to 1 stop per 3 seconds per application, and to 20 lifecycle actions per 15 seconds per user across all applications, with a 60-second block once that cap is hit.

### Parameters

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  The ID of the application. You can find this in the URL of your application's dashboard.
</ParamField>

### Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful.. `success` if successful, `error` if not.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
      "status": "success"
  }
  ```
</ResponseExample>

### Common errors

| Code            | HTTP | Meaning                                                                     |
| --------------- | ---- | --------------------------------------------------------------------------- |
| `ACTION_FAILED` | 409  | The cluster rejected the action, for example the application is mid-deploy. |